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e’re always amazed by what the 

Raspberry Pi community builds using 

the Pi Zero W (Raspberry Pi’s smallest 
wireless computer). We’ve seen miniature game 
consoles, photo frames, magic mirrors (plus other 
small display projects), drones, tiny robots, and 
smart devices around the home. The Pi Zero W is 
small, cheap, sturdy and, crucially, incredibly well 
engineered. No wonder it’s so popular. 

But Raspberry Pi isn’t the only platform out 
there. Another board that’s often used by digital 
makers is Arduino. People often think of Pi and 
Arduino as rivals, but they are very different 
devices. Raspberry Pi is a computer platform, while 
Arduino is a microcontroller, ideal for controlling 
precision elements like servos and DC motors. 

Putting the two together creates an unstoppable 
tag team. You get more done if you stop thinking 
about which widget is best, and start thinking 
about how components could work together to get 
the best result. 

That’s why this month we’ve got two incredible 
features: 10 Pi Zero W Projects, plus Arduino and Pi. 
Read both features and you'll be capable of building 
bigger, better, and bolder projects. Never limit 
yourself to just one approach, device, or project. 
The more tools you can use, the better a digital 
maker you’ll become. 
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Editor - The MagPi 
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FEATURE 


TEN MILLIONTH 


RASPBERRY PI 
MADE IN WALES 


British Raspberry Pi manufacturing proves hugely successful 


Right Eben and the 
team at Sony UK 
TEC celebrating 
the landmark 

ten millionth 
Welsh-made Pi 


he Sony UK Technology 

Centre (Sony UK TEC) has 

announced the production 
of the ten millionth Raspberry Pi 
made in the UK. 

Raspberry Pis were originally 
made in China, but in 2012 Sony 
UK TEC was contracted to make 
10,000 units. However, a Sony UK 
TEC spokesperson confirmed that 
the facility “went on to produce 
one million [Raspberry Pi boards] 
in its first year.” 

Steve Dalton, Sony UK TEC 
managing director, said, “The last 
five years have seen unprecedented 
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growth across our Pencoed 
facility - something we are 
understandably proud of.” 

The Pencoed facility was chosen, 
a Sony UK TEC spokesperson 
explained, “due to the facility’s 
capacity and innovative automated 
processes.” Based roughly 13 miles 


is a Significant achievement 
for everyone involved in its 
production, especially our devoted 
Sony Team, The Raspberry Pi 
Foundation, and distributors 
Premier Farnell.” 

Raspberry Pi co-founder 
Eben Upton joined Sony UK 


west of Cardiff, the Sony UK TEC 
facility “has seen staff numbers 
leap by 200, taking its team of local 
employees to 540” over the last 
five years. 

Steve added, “Our growth has 
been intrinsically linked to the 
success of the Raspberry Pi. This 


TEC to celebrate the milestone, 
saying “when we initially began 
manufacturing [Raspberry Pis] 
here at Sony UK TEC, we could 
never have imagined it would be 
the soaring success it has become - 
and for that we are grateful to Sony 
and our distribution partners.” 
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Made in Britain... 

in Japan? 

Eben attributes much of the 
success of the Raspberry Pi to 
Sony UK TEC’s “unparalleled 
manufacturing standards, 


Gareth Jones and Joe Whaley from 
Sony with Romain Soreau from RS and 
Sarah Fawcett from Premier Farnell 


develop new processes and drive 
innovation. We were able to support 
The Raspberry Pi Foundation 
further by introducing Pi 


Our growth has been 
intrinsically linked to the 
success of the Raspberry Pi 


comprising the latest 
techniques and the very best 
engineering talent.” 

Steve Dalton added that making 
Raspberry Pis in such volume “has 
challenged our highly skilled team 
of engineers and technicians to 
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manufacturing to our counterparts 
in Japan, and there is now a ‘made 
in Japan’ version of Pi.” 


No Raspberry Pi 4 yet, 
though 

Speaking with Beta News 
(betanews.com) at a separate 
event, Eben was asked whether we 
might see a Raspberry Pi Model 4 
sometime soon. His response 
was, “Nope!” 

Eben clarified: “I think we gave 
the impression by launching Pi 2 
and Pi3 a year apart that we were 
establishing some sort of annual 
cadence. We’ve said that we think 
the Raspberry Pi 3 is more of a 
three-year platform.” 

Even that is a very soft timeline, 
though, as Eben added, “we’re not 
much more than a year into that 
(very rough) window yet.” 


Eben (left) with Steve Dalton, 
Sony UK TEC managing director 


PIS IN MILLIONS 
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One child had created a robot that 


MINI MAKER FAIRE AT THE INSTITUTE OF IMAGINATION 


MINI MAKER 
FAIRE Al THE 
INSTITUTE OF 
IMAGINATION 


Fuelling kids’ imaginations with a full head of STEAM 


ondon-based charity, the 
Institute of Imagination 
(lol, www.ioi.london) 
hosted a Mini Maker Faire at its 
magination Lab on 29 July. 

The event featured activities 
from retro computing and 
aser cutting to robot football. 
We caught up with Corrie Jones, 
ol interim marketing manager, 


would pick up all the rubbish from 
the bottom of the ocean 


Below Each 
SoccerBotz houses 
a Raspberry Pi and 

an Arduino 


SS 


after the show. “We’re really 
happy to have had so many 
people attend, and to see so many 
children get so involved in all of 
the activities,” she told us. 


8 | MagPi September 2017 


“Our current theme is ‘Teaching 
Me’, and is all about inventing 
things that you think will make a 
positive impact in the future. One 
child that I spoke to had created 
a robot that would pick up all the 
rubbish from the bottom of the 
ocean. Inventions [like that] show 
a really high level of thinking 
about what we need to improve 
the world.” 


Pi-powered robot football 
Red Robotics (redrobotics.co.uk) 
brought some SoccerBotz to make 

a three-a-side Pi-powered robot 
football game. “That was brilliant,” 
remarks Corrie. “I didn’t get to 
have a go on it myself because it 
was so busy throughout the day!” 


| 


Above RedRobotics' SoccerBotz were a hit 
at the lol's Mini Maker Faire 


The SoccerBotz used a Pi to handle 
the remote-control instructions and 
motors, but also used an Arduino to 
run the power control system. The 
Arduino can be programmed directly 
from the Pi, as we explain in our 
guide starting on page 60. 


STEAM power 

IoI focuses on STEAM learning, 
adding art and design to science, 
technology, engineering, and 
maths. So, “as well as there being 
science and technology elements,” 
to lol events, Corrie says, “the arts 
and things that [kids] can make and 
feel really proud of” also feature. 
The Iol runs many weekend 
activities, all aimed at children, 
families, schools and teachers, 
and covering everything from 
film-making to coding and 3D 
design. Visit ioi.london/whats-on 
for details, or contact the Iol at 
hello@ioi.london to bring an 
‘Imagination Pod’ to your school. 


= 
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Includes custom NOOBS, Raspbian PIXEL, and Raspbian Lite on a bundled 
SD card. Organize multiple projects in one place with Project Spaces and 
easily assemble components in a custom enclosure. 


© WDLABS Learn more at wdlabs.io/mp60a 
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ZEROCAM / PIONEERS WINNERS 


ZEROCAM RELEASED 


A bespoke Pi Zero camera range 


Below 

Each ZeroCam 
comes in a metallic 
case with magnetic 
clasp - sounds like 
a body cam case 
to us! 


he Pi Hut (thepihut.com) 

has released the first full 

range of cameras designed 
specifically for the Pi Zero. The 
cameras are smaller than the 
standard official Raspberry Pi 
Camera Modules, and connect 
directly to the smaller CSI ports 
of the Zero boards. 

The range includes a standard 

camera, a fish-eye camera, and 


Zer@Cam 


© PiHut 


ANNOUNCED 


Who ‘Made it Outdoors’ the best? 


a NOIR infrared camera. Despite 
the module’s reduced size of 
just 11.4*11.4 mm (compared to 
the 25x23 mm of the standard 
Module), it still packs a 5MP sensor 
(compared to the 8MP of the V2 
Camera Module). 

The Pi Hut’s Jamie Mann tells 
us, “We sampled a bunch [of 
camera modules] from various 
manufacturers, found the best 
factory for the job and created 
the ZeroCam brand.” 


Right The ZeroCam 
is designed to fit 
the reduced-size 
camera connector 
on the Pi Zero 


he winners of the second 
Pioneers challenge, 
a digital making projgram 
for 11-16 year-olds, have 
been announced. 
The overall theme winner is HH 
Squared’s Pi Spy project. 
Pioneers challenges young 
people to work together to create 
a piece of technology addressing 
a theme, with this cycle’s theme 
being ‘Make It Outdoors’. 
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The next Pioneers 
challenge will be 
set in September 


Pioneers organiser Oly Brown 
says of HH Squared’s project, 
“We really loved how every 
member of the team contributed 
[and] how tech was used to 
enhance the enjoyment of 
the outdoors.” 

The Pioneers challenge isn’t 
just about making something, 
but the process of trying to make 
something. Coding Doughnuts 
won the Inspiring Journey prize by 


# MakeYourideas 


Jamie explains that the 
ZeroCams “work with the 
existing camera code.” He also 
predicted that we”ll see smaller 
camera connectors on future 
models of the Pi: “There are 
already smaller ones out there... 
it’ll happen!” 

The ZeroCam, ZeroCam FishEye 
and ZeroCam NOIR cost £15 each 
from thepihut.com. 


explaining all the problems they 
encountered while trying to build 
a smart picnic hamper. 

Equally, Uniteam’s “great 
explanation of such a wonderful 
project” earned it the Best 
Explanation prize. Watch their 
YouTube video, Plantz with a Z 
(magpi.cc/2vfHueC). 

Don’t miss the next Pioneers 
challenge - sign up to the 
newsletter at magpi.cc/20MN2rc. 
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The stories we shared that 
flew around the world 


NEEDS YOUR 


VOICE 


New open-source project to make voice-based 


making easier 


oogle’s new Open Voice 

Project aims to make AIY 

Projects ‘more responsive’ 
by providing ‘a set of open-source 
voice keywords to use.’ 

But the project needs your help: 
the more people who provide a 
sample of their voice, the better 
the speech recognition gets. 

“We have around 2,000 
recordings of each word so far,” 
Google engineer Pete Warden 
tells us, “but the more diversity 
in accents we can get, the more 
people the speech detection will 
work for.” As a Brit abroad, Pete 


Google's new project should 
decrease the learning time for DIY 
voice-based builds 


raspberrypi.org/magpi 


has often found himself having to 
spoof an American accent to make 
voice systems work. 

The project is only aiming 
to “enable a very basic voice 
interface”, Pete reveals, with 
single-word commands like ‘stop’ 
or ‘open’. 

Pete also confirms that the Open 
Voice Project will always be open: 
“We will be releasing the recordings 
under a Creative Commons BY 4.0 
licence,” he discloses. 

You can help the project now by 
turning on your microphone and 
heading to magpi.cc/2wmoosl. 


magpi.cc/2tMa3jf 


Can you really use a Raspberry Pi 3 as your main 
computer? After all, that quad-core 1.2GHz processor 
and 1GB of RAM should be plenty for office work. 
Follow the link to see if it's possible! 


magpi.cc/2tEUcCT 


Julia, a next-generation coding language for data 
analysis and scientific research, is now available on 
the Pi. With the claimed ‘speed of Fortran and ease 
of Python’, Julia's a decent choice for hobbyists, too. 


magpi.cc/2usunnP 


Microsoft has launched an online Raspberry Pi 
simulator. It's early days, but it could be a useful 
way to prototype projects without breaking out the 
breadboard - never mind the soldering iron! 
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BETTER OIL DRILLING WITH A RASPBERRY PI 


Wells can be managed 
through a smartphone 
app as well as at HQ 


fe 
PETROLOG 


Pi T. ~ec 
FIRE?) 


1 


BETTER OIL DRILLING 
WITH Å RASPBERRY PI 


Pi-based smart controller increases revenue by $7,000 


exas-based Petrolog The need for a smart meter people going to the well every day. 

Automation arises at so-called ‘marginal Also, our controller is smart, so it 

(petrologautomation.com) wells’ (also, we are told, referred finds the best times to be pumping 
has created a smart oil well to as ‘stripper wells’). As Carlos and thus increases production.” 
monitor that increases the revenue Labrado, software developer Carlos tells us that Petrolog 
from each well by a reported at Petrolog, clarifies: “these chose the Raspberry Pi for version 
$7,000 (roughly £5,300). The wells are low-production one due to its size, low cost, and 
smart monitor is based around a wells that are often thought features. “Now we keep using 
Raspberry Pi and a custom-made of as not worthy of a POC it because of the great support 
cellular modem. [Pump Off Condition] controller.” community... like resinOS.” 


Our controller is smart, so it finds Resin.io 


The Pi embedded in the Petrolog 
i 1 POC controller runs resinOS 
the be ol time S to be pumping and (resinos.io), a dedicated Internet 
' ' of Things (IoT) operating system 
thus increases production Hom salen Davis 
director of product marketing 
As the fluid level in these and strategy, explains, “Because 
marginal wells fluctuates, an resin.io uses Docker containers 
engineer must visit each well every to deploy updates, the Petrolog 
day to ascertain the fluid level and team can change the application 


set the pump accordingly. Some running on their oil well monitors 
of these wells are over four hours’ as often as they like, without fear 
drive away. of bricking devices.” 

Carlos explains the benefit of “Anybody can get started with 
Petrolog’s POC controller: [It] resin.io,” Alison tells us, “whether 
saves money by not having the you’re a hobbyist with a few devices 
well turned on when there is not at home, or a professional with a 
enough fluid, and not having fleet of thousands.” She confirms 


Left Spot the Pi embedded in Petrolog's DE ne accent 
custom-made cellular modem and casing accommodates up to five devices. 
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USING APIASA 


PLUG-IN & 
PROCESSOR PE 


Big data in little Pi 


cott Edenbaum, a recent graduate 

from the NYC Data Science Academy 

(nycdatascience.com), has turned a humble 
Pi Zero into a data crunching, code trialling, data 
science-ing auxiliary processor. 

Wanting to avoid “the potential for security 
exploits” of installing MySQL on his main 
development computer, Scott instead used 
virtualisation software Docker (docker.com) to 
create standard environments for Python and R 
(a programming language suited to data science). 

Scott’s approach avoids the “multiple (possibly 
conflicting) dependencies” of Python and R, while 
allowing him to create his sandbox coding and 
testing environment quickly and easily. Building the 
environment from scratch each time is “a process 
that takes 2+ hours on a Raspberry Pi 3”, let alone 
a modest Pi Zero. 


Plug-in processor 
“Because the device is so inexpensive, I can see there 
being a lot of possibility using it for education” Scott 
tells us, while the standardised environment saves 
“headaches” such as installing libraries and managing 
package repositories. 
Scott’s project could replace Excel “for some tasks”, 
while Docker “allows deployment and management 
of a few devices or hundred, without too much extra 
work.” He says there are “a lot of interesting cases I 
haven’t thought of.” 
The project is on GitHub at magpi.cc/2uh3guV, 
and Scott has documented the installation process 
at magpi.cc/2fmMPdJ. 
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Crunching 
big data sets 
doesn't need 


to involve 
big hardware 
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GoPiGo 


20+ new projects for your Pi robot car. 


BrickPi3 


LEGO MINDSTORMS + RASPBERRY PI 


Running the software on the Pi 
means you can control it from 
any networked device 


www.dexterindustries.com 


September 2017 MågPi 


13 


pi-topOS 
Learn. Play. Create Quick Launch Notes 
The OCR* endorsed pi-topOS 
(Operating system) platform comes 
pre-installed on the 8GB SD card 
shipped with every unit. pi-topOS 
software suite lets you - browse the 
web, - check emails, - create and 
edit Microsoft Office compatible 
files. It includes pi-topCODER and 
comes with the revolutionary 
educational game CEEDuniverse. 


i-t DER 
pi-topCO v 


pi-topCODER is the interface that 
à allows you to access worksheets 
and pre-built Raspberry Pi projects. 
It's the easiest way to tinker or 
deliver lessons by providing 
g step-by-step guides for computer 
> mn [før =| [noen ST ron [a| [ae Cam science and STEAM worksheets. 
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More power to you 


> 
LEARN 


pi-top on 
pi-topCEED 


The modular all-in-one 
Raspberry Pi powered desktop 


WWW.PI-TOP.COM 


K Adjustable 
Viewing Angles 


14” 
HD Screen 


ug Modular 
a Components 


pi-top 


The modular build-it-yourself 
Raspberry Pi powered laptop 


@ 10 Hour 
Battery Life 


13:37 
HD Screen 
1 Modular 
= Components 


n 
i-to Worldwide shipping available in green or grey at www.pi-top.com or our distributors 
p p Stay up to date with our latest news by following our social media 
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The Pi Zero W is a 


dding wireless internet connectivity 
e e ° to the original Raspberry Pi Zero was 
fantastic piece of kit, i 


at the top of many people”s wish lists 


and these pages are when it was first launched. A real computer, 

e P amazingly small, with a built-in internet 
packed with ideas connection - this opens up so many possibilities 
to inspire your Pi for amazing projects. 

7 ti e t Since its release in February 2017, the Pi Zero W 
ero creativity has been used in many amazing builds around the 


world, so we thought it was about time to highlight 
some of the exciting things you can do with the 
newest member of the Raspberry Pi family, and the 
original Pi Zero as well. Let’s get making! 
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Connect to an HDMI display 
to create your own media PC 
or interactive project 


This features the same CPU as in 
the original Raspberry Pi, although 
it's clocked a Little higher 

Connect to a wireless network 
or Bluetooth with the radio chip 
on the Pi Zero W 


m: 
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The Raspberry Pi Camera 
Module can be added for 
photography projects - all you 
need is an adapter cable 
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feature 


GETTING 


Quick tutorials for your Pi Zero 


GPIO HEADER 


Add GPIO pins to your Raspberry Pi Zero 


YOU'LL NEED 


GET READY TO SOLDER 


Put the short legs of the 40-pin 
header through the GPIO holes 
on the Pi Zero. We like to turn it 
upside down so the side of the Pi 
Zero with the header is raised off 
the floor, giving a perfect view of 
the pins to solder to the board. 


SOLDER THE PINS 


Let your soldering iron heat up 
and then solder the individual 
pins. Make sure no solder crosses 
between the pins or you may short 
them out. Be careful - soldering 
irons are extremely hot, so let the 
solder cool before touching it! 


Connect USB accessories 
quickly and easily 


RA 
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hile you can do a lot of things with the Pi 

Zero, it’s worth sharing a few tips to help 

you use it in even more projects. These 
can be as simple as software tweaks to improve 
performance and reduce power requirements, or 
adding hardware to make it easier to integrate into 
your projects. Here are some of our favourites. 


HAMMER HEADERS 


Pimoroni has an excellent 
solution to adding a GPIO header 
to the Pi Zero: a special header 
that can be hammered into the 
holes with a special kit. You can 
find out more on Pimoroni's site: 
magpi.cc/2lohN2U 


THE USB PORT 


A lot of micro USB to USBA converters can be bulky, 
using wires and full-sized female USB|A ports. A great 
alternative is to use a micro USB shim, which is only 
as big as the connector. This allows you to convert the 
data port while losing minimal space. 


D) You can buy HATs and other add-ons to add 

USB ports to the Pi Zero without making the Pi 
Zero wider or longer, but these options will more than 
double its height. If you’re feeling extremely brave, you 
could try removing the micro USB and soldering ona 
standard USB A connector, but we don’t recommend it 
unless you really know what you’re doing. 
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Look to the top right-hand corner 


of the Pi Zero and you'll see two 
holes labelled TV, below the GPIO 
holes and next to two pins labelled 
RUN. Put the short ends of the 
header through the TV holes, flip 


the Pi over, and solder them on. 


Two-pin header 
2x female-to-male jumper wires 
Screw terminal with RCA connector 


O 

bo000000000 
93000000 

D9 00000 ok 


A COON bes 


If the video looks wrong, 
switch the jumper cables 
over on the Pi Zero 


CONNECT TO WIRELESS 
ON THE COMMAND LINE 


You'll need to know the SSID and the password 
of the wireless network. You can run a scan of 
available wireless networks using sudo iwlist 
wlanØ scan 


Open the wpa-supplicant file with: 


Go to the bottom of the file and enter: 
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000000 
000/0.00 


Slot the jumper wires onto the 
headers, and put the other 
ends inside the screw terminals 
of the RCA plug. The Pi Zero 
should automatically switch 

to this output when you plug it 
into a TV. 
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few years ago, when the Raspberry Pi was 

fairly new, Adafruit produced an excellent 

guide to creating something called the Onion 
Pi. The concept was to take a Raspberry Pi, connect it 
to the internet, and then connect to the Raspberry Pi 
via WiFi. Once connected, you could then access the 
internet, encrypted via the Tor network. You can read 
the original instructions here: magpi.cc/2vCkTqq. 

We’re going to do something a little more 

straightforward, and remove the Tor functionality. So 
this will be a simple, tiny, wireless access point. } 


Latest version of Raspbian 
USB Ethernet adapter 

An extra wireless dongle 
(advanced) 


We need a lot of software to get the wireless access 
point working. First, update your Raspberry Pi with: 


Then install: 


You'll need to turn off some of the new services 


you've just installed using: 
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This works best with an Ethernet connection, but 
you should be able to use a wireless connection 
- with some caveats. We need to bridge the 

connection between the internet (ethØ) and the 


wireless network (wlan@). 


Edit the DHCP file by first using sudo nano /etc/ 
dhcpcd.conf and add denyinterfaces wlan@ 
and denyinterfaces eth@ to the bottom of the file. 
Save and exit, and then create a bridge with: 


Connect the network ports with: 


Open the network interfaces file with sudo nano 
/etc/network/interfaces, then change the 


wlan info to manual. 


With that done, add the information for the bridge 


to the file. 
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Now, we need to edit the hostapd file to allow 
another computer to connect to the Raspberry Pi. 
Open the file with sudo nano /etc/hostapd/ 
hostapd.conf and add the following, putting in 
your own network name and password: 


Save the conf file and open another file with sudo 
nano /etc/default/hostapd. In this file we can 
tell the system where to find the configuration file 
we edited. Find the line HDAEMON CONF and replace 
it with: 


Save, exit, and then reboot the Raspberry Pi. | 


You should now be able to connect to it from 
another device. 
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e’ve seen some great 

projects that use 

Python doesn't come with a built-in Bluetooth Bluetooth tags and larger PyBluez - magpi.cc/1VOuGCy 
module, so we need to install pybluez to our Raspberry Pis. With the Pi Zero W, Bluetooth tag or another 
Raspberry Pi. Do a standard sudo apt-get you can create a smaller tag that Bluetooth device 

update and sudo apt-get upgrade before you slips easily into your pocket. 

start. Once that's done, install the following: There are many applications that 

support this, but here’s how to get 

your tag set up. 


This is pip, the Python module installer. It works like 
apt-get, but has a different repository of software. 
We can then install pybluez using: 


You can use specific Bluetooth tags that send 

out a signal and MAC address, or you can set an 
existing device like a PC or phone to transmit its 
Bluetooth signal, which the Pi can detect. If you're 
using a tag, you could carry it with you and leave 
your Pi Zero at home. 

A tag will usually tell you what its MAC address 

is, but Windows, Android, and iOS all use slightly 
different methods for other devices. Use Google to 
look up how to find the Bluetooth MAC address for 
your device. 


Now you know your MAC address, you can plug 
it into the tag code listed on this page. The code 


is simple - it scans the surroundings once every 
20 seconds and looks for the specific Bluetooth 


MAC address. If it finds the correct address, it lets With the PI Ze IO W, you can 


you activate the next stage, whatever you want that 


to be. With that in place, you can start using this cre ate a smaller tag that slips 


setup to automate your projects! 


easily into your pocket 
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HOW TO USE A 


Creative projects for 
your Bluetooth tags 


H 
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Microphone 
Speaker 


The Raspberry Pi Zero is great 
for cosplay, as you can do 
some pretty complex things 
with it while secreting it away 
in a hidden nook of your outfit. 
Voice amplifiers or distorters 
are something many cosplayers 
will consider at some point, 
depending on their costumes. 
We like the simplicity of 
this version, using a clip-on 
microphone. The sound is input 
to and modified by the Pi, before 
being sent to the attached 
speaker. This version is used for 
a Star Wars Mandalorian bounty 
hunter costume, which is really 
cool, but the project could be 


adapted for other cosplay as well. 
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Adafruit Free Digital Library 


This hotspot does not provide an internet connection, You can download any book provided and save to your device for viewing later. 


Button 
Video files 


Popularly known as the Simpsons 

Shuffler or Simpsons Button, 

this very simple Pi Zero project 

features a selection of Simpsons 

episodes. When you press a full Simpsons experience, there's 
button, the Pi Zero plays a random a 3D-printed case design you can 
episode. Obviously, you could download as well. 

do this with any media (even If you are choosing Simpsons 
music), and all it requires you to episodes, we suggest limiting 
do is solder a button to a GPIO pin yourself to seasons three to eight. 
and load a Python script. For the You'll thank us later. 


Storage space 


USB power supply 


This is a simple but excellent 
idea: attaching a Raspberry Pi 
Zero to a USB power adapter 
so that the form-factor of the 
computer is the same size as a 
plug. This can then be used to 
run a mini server, or even as a 
travel computer. This version of 
the project by NODE on YouTube 
also includes a USB hub, so you 
can easily connect storage and 
other peripherals to the Pi Zero. 
The video includes a guide on 
how to build the power supply. 
Be careful - you're dealing with 
mains power! Don't take any 
risks with this project. 


i 
| 
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Disney and Lucasfilm might want 
to push BB-8 as the new coolest 
sidekick, but we all know that 
R2-D2 is the best droid in the 
Star Wars universe. Making your 
own remote-controlled R2 is an 
extremely popular maker hobby, 
so much so that the version of R2 
that appears in the new Star Wars 
films is one of these hobby-builds 
(magpi.cc/2wAFbAM). 

This version is a little more 
straightforward, and instead of 
creating a one-to-one replica 
of the astromech, it's a mod of 
a small toy. This makes it much 
easier to hack using a Pi Zero and 
some small motors. 

It might be a bit tricky to track 
down that particular R2-D2 toy 
these days, though... 


PI-POWERED 
R2-D2 


Prototype board 
0.96-inch screen 
Laser-cut case 


We'll be honest here: this 

project is more about what 

you can do with the available 

technology than about making 

a neat, portable arcade 

cabinet. It's so small that it's 

not particularly comfortable the oldest of arcade games. The 
to use, but that doesn't mean buttons are soldered to some 


it's not an incredible feat of custom-made prototype boards, 


Raspberry Pi engineering. and the case is a custom design 
The back of the cabinet is the in laser-cut acrylic. Adafruit 

same size as the Raspberry Pi themselves say the design 

Zero, while the front is a little process was more of a challenge 

deeper than the board. It uses a than anything else but hey, it 

tiny 0.96-inch OLED screen, with would be a cool project to break 

a resolution of 96x64, perfect for out at a party. 


| | 
Saptembel 2 17, 
PR) 
i 


f 
Hf 
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R2-D2 toy 
Motor controller 
Motor and wheels 


Old monitor or TV 
Two-way mirror 
Wooden frame 
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DASH CAM 


The ZeroView is a cool and 
cheap add-on for the Raspberry 
Pi Zero that allows you to 
connect the Pi Zero, via suction 
cups, to a window. It includes a 
special mount for the Raspberry 
Pi Camera Module that means it 
can film through the window at 
the same time. 


Projects like this are surprisingly 
easy, and we've covered a couple 
like them in the magazine before: 
from quick, simple hacks of 
NES controllers, to installing a 
rechargeable battery system into 
a fully enclosed SNES emulator. 
All you need to do is find a 
way to connect the controller's 
USB cable to the Pi Zero. You 
can swap the USB connector 
for a micro USB connector; you 
can solder each individual USB 
wire to the Pi Zero's USB port if 
you're feeling brave; or solder 
them to the GPIO and make 
some modifications to the code. 
RetroPie lets you very quickly and 
easily configure your Pi Zero to 
play old games, and from there 
it's up to you how you use it. 
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ZeroView 


With very little in the way 
of additional coding and 
accessories, you can easily turn 
it into a dash cam for your car, 
keeping an eye on the road 
ahead just in case. It could even 
be used on track days to film 
your amazing lap-times! 


DAC 
Amp 


Wooden case 
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SUBSCRIBE TODAY AND RECEIVE A 


DOR 


Subscribe in print for 12 
months today and receive: 


A free Pi Zero W (the latest model) 
Free Pi Zero W case with three covers 


Free Camera Module connector 
Free USB and HDMI converter cables 


Other benefits: 


Save up to 25% on the price 
Free delivery to your door 


Exclusive Pi offers and discounts 


Get every issue first (before stores) 


N Mini 
N box 

Å video Juke Piker 

| GMARTER video spentar 

å 


| TURN A PI ZERO W INTO i 
A WIRELESS USB DRIVE 


Å HACK A FIDGET SPINNER fl 
INTO Å GAME PAD 


av MAKE YOUR OWN fl 
EARTHQUAKE MONITOR 


th Raspberry Pi 
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> Å set of three 


intercoms 
originally cost 
£99.95 in 1986 
> Martin bought 
his set for a 
bargain £4 


> He put the Pi 


perinde Eager to evoke a sense of nostalgia, retro nut Martin Mander decided 


case's grille 


to place his Google AIY kit inside an old FM wireless intercom 


coated with 
matt-finish 
craft paint 


hen Martin Mander saw 
The MagPi was giving away 
> He'd like to | : 
include a a free hardware voice kit 
manual rotary from Google in issue 57, he did the The speaker from 
volume control sensible thing and rushed off to the kit was too big, 
buy a copy. But after he assembled 2 ene se 5 
the components, placed them 
in the cardboard housing, and 
pressed the button to activate the 
Google Assistant to ask a question, 
he started to think about the 
future possibilities. 

Ironic, then, that he promptly 
delved into the past. "The family 
and I enjoy the local car-boot sales 
and I’m always looking for old, 
obsolete or broken technology 
that I can use in projects,” he says, 
relishing the chance of picking 
up something from the 1970s 


*UOJESIN MMM 
SIA 


ap 
N@LV 


and 1980s. å Å Knowing his children would give 
: . : l 3 3 the unit a pounding, Martin used 

He noticed some intercoms which ; Hen 
were in their battered original 4 er 4 y the microswitch stayed in place 


packaging, and he thought it’d be 
fun for the kids to be able to chat 
between their rooms. “They didn’t 
work, and so I shelved them in 

the workshop,” Martin continues. 
“Then the Voice HAT came along 
and I decided it would be nice 


to preserve the spirit of these 4 FE 
rå i li Ea" 


Each component had its own 
connectors and cables which, 
thankfully, were also long 
enough for the new case 


00000000. 


intercoms in a small way.” men 
Martin’s idea was to fit the Google 

ATY kit into one of these old units. 

“Pd followed the instructions in The 
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>STEP-01 
Using IFTTT 


|e | Complete trigger fields 


DT Crate incas MG 


>STEP-02 


Finding Google Assistant 


Send a text 
message to 
someone with 
your Android 
and Google 


>STEP-03 


Organising the response 


Martin wanted to expand the Google Pi 
Intercom's abilities, so he logged into ifttt.com, 
clicked My Applets, selected New Applet, and 
then clicked the ‘+’ icon on the next screen. 


Having searched for Google Assistant and 
clicked Connect, he signed into his Google 
account. He could then select a trigger 


and fill in the phrases that would activate it. 


His idea was to get the intercom to 
send a text to his wife when he says 
he’s home. He chose SMS as the action 
service and filled in his mobile number. 


MagPi to assemble the HAT and get 
the software up and running on the 
Pi,” he recalls. With the Piand HAT 
running on his desk, he tested some 
voice commands before getting 
on with the task of cracking open 
the old intercom. “There’s always 
a slight feeling of naughtiness in 
ignoring the ‘do not open’ warning 
and seeing what’s inside,” he says. 
“The great thing about older tech is 
things tend to be screwed or bolted 
together, allowing them to come 
apart nicely, leaving just the case.” 
Having made lots of tiny 
measurements, he was convinced 
the kit would fit, so he cleaned and 


There's always a Slight feeling 
of naughtiness in ignoring the 
‘do not open’ warning 


spray-painted the front of the case, 
let it dry, and began bolting the 
Pi into the case, adding the other 
components around it. “I set aside 
the green push-button from the kit, 
but kept the microswitch and fixed 
it inside the case alongside the big 
hinged intercom button.” 

Getting the microswitch in exactly 
the right place was the greatest 
challenge and it involved lots of 
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trial and error: “Because it was 
being activated at an angle by the 
rear of the button, even a couple 
of millimetres made the difference 
between the microswitch sticking 
‘on’ or there being too much play 
in the action.” 

Martin then removed the LED 
from its case and soldered in a two- 
hole component connector to secure 
it between the Pi’s USB ports, under 


ft The project 
used a repainted 
and cleaned 
intercom bought 
from a car- 
boot sale 


the original microphone grille. 
“The kit’s microphone board was 
just glued into place once På drilled 
holes in the top of the case. Once 
that was in place, I connected the 
cables and closed the case.” 

Martin is pleased with the result: 
“The kids have described it as 
fancy and futuristic, which P1 
happily take.” He has since linked 
the intercom to his IFTTT account 
(see ‘A connected home’ box). 
“This took some configuring,” 
he concludes, “but thinking up 
responses for the intercom to read 
out when the triggers are activated 
was really good fun.” 
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MATT, BOMANI & EUNICE 


Matt Zheng, Bomani McClendon and 
Eunice Lee are students of design and 
computer science at Northwestern 
University in Illinois. 
magpi.cc/2vANCvc 


Image: Eunice Lee 


WRT'S YOUR MOTTO? gi 


Turn the sound of your voice into a printed waveform Above Two printouts of different responses, 


both answering the question on the left 


”m grateful for finishing | 7" = 
this project,” says maker F 
Eunice Lee as she holds a | 


button while speaking into a large 
silver microphone. Å printout of 


The project the sound waves produced by her 
took 7-8 hours voice emerges from the device’s 
to make 

thermal printer. 
Acontroller This is a demonstration of 


script handles 


Waves, a side project created by 


subprocesses 
Matt Zhang with Eunice Lee and 

There's no p 

edu: Bomani McClendon, students 

recording of design and computer science 

length at Northwestern University 

The same in Illinois. 

amount of "During our first meeting, we 

paper is used j ar 

éach time shared some inspiring hardware 

, Å projects we’d seen, and hada 

Build details 7 1 

and code are brainstorm session where we drew 

on GitHub out lots of wild, funny, and weird 

er project ideas on Post-it notes,” What's your motto? Make a wish! 
recalls Bomani. “Afterwards, - e 


Below Matt Zheng we voted on the ideas and filtered dn z —— 


looks pleased withthe them by feasibility, materials 
thermal printout of his oct, and (most importantly) 


answer - we wonder i What are ateful Give us your 
what he's grateful for! excitement. We chose Waves, for today? best lauok 
= = —— 


Image: Matt Zheng 


wat are You srateful for e | 


TT << 


Users choose The thermal 
to answer one printer plots a 


Holding the relevant 
colour-coded button, 


the user records 
their answer 


of four open- waveform of the 
ended questions recorded response 


| Image: Eunice Lee 


32 | MågPi September 2017 raspberrypi.org/magpi 


and later learned that Raspberry Pi 
would work well for the project.” 
Meeting for weekly sessions, 
it took the trio two to three 
months to create the finished 
project. “We encountered a fair 
number of problems during every 
work session, but we managed 
to overcome them by the end,” 
reveals Matt. 
“Having a couple of ground 
rules set from the beginning really 
helped,” reckons Eunice. “For 


We all brought different skills to 
the table, but a mutual excitement 
for Waves and what it could be 


instance, we decided to always meet 
once a week and to commit toa 
project that would take less than ten 
hours to build. This kept the project 
ightweight, fun and stress-free.” 

“For me, the best part of this 
project was getting to work with 
Eunice and Matt,” says Bomani. 
“We had a lot of laughs during 
our sessions.” 

“We all brought different skills to 
the table, but a mutual excitement 
for Waves and what it could be,” 
adds Eunice. 

After brainstorming ideas for 
open-ended questions for users 
of Waves to answer, the team 
narrowed them down to the final 
four. “We wanted the questions to 
be personal and reflective,” explains 
Eunice. “That way, receiving a print 
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Image: Matt Zheng 


of the sound waves would mean 
more to the participant.” 

A Python script converts the 
recording of the user’s answer into 
a graphical waveform to print. 
“The programming wasn’t too 
tricky, since we borrowed a lot 
from open-source Python code,” 
says Matt. “The plots take up the 
same amount of paper, no matter 
how long the recording is, but 
we have to manually adjust the 
volume on the microphone, to 


make sure that the audio doesn’t 
blow out or disappear entirely.” 
The result can also be uploaded 
to a locally hosted website, which 
was displayed on a monitor during 
an annual Design Expo at the 
university. “The idea for the website 
was that people could see other 
people’s sound waves and wonder 
what was said,” says Eunice. “It was 
a really fun addition that turned 
some heads and made people 
interested in what our project was.” 
Eunice was delighted with the 
overall reaction to Waves: “It 
was really great to see people’s 
faces light up when they finished 
recording and saw their sound waves 
being printed. [...] The best part was 
being able to give that to the user 
and say, ‘You can keep it!’.” 


PRINT 


WAVES 


Projects 
OUT 


YOUR VOICE 


mig 


>STEP-02 


>STEP-03 
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> Daniel 
estimates a 
Pi Deck setup 
costs $182 


> There is no 
soldering or 
modification to 
the turntable 


» Audio Injector 
sound cards 
cost around £20 


> A Serato CVo2 
control vinyl 
pressing is 
recommended 


> The FLAC 
music format 
gives the 
best results 


DECK 


Digital music can’t be scratched - or can it? Daniel James and 
Chris Obbard go ‘old school’ with a Pi-based digital vinyl system 


ver since he saw 

Breakdance: The Movie in 

1984, Daniel James wanted 
to be a DJ. But he soon realised 
scratching expensive vinyl or 
carting it from venue to venue is 
far from ideal. “Unless you are 
famous enough to have a roadie, 
large boxes of vinyl are heavy and 
impractical,” he tells us. There’s 
also the problem that a lot of music 


This specially tweaked version 
of xwax lets you load tunes 
and see their waveforms 


As you interact directly with 
the record, the Pi senses 
the needle's position 


is not being released on analogue 


vinyl, d 


have lo 
They al 


ow you to DJ 


espite the huge resurgence 
of interest in the format. 
Digital Vinyl Syste 


ms (DVS) 


ng provided an alternative. 


using digital 


music files and software while 
letting you benefit from the feel 
of a turntable. You simply place a 
special vinyl record on a standard 
turntable and the system will read 


the position of the stylus froma 
timecode. This is used to play back a 
digital music file at the same point 
in time — but these systems can be 
hugely expensive. 

Not now. Daniel and his colleague 
Chris Obbard at 64 Studio put a 
Raspberry Pi3 alongside a standard 
vinyl deck, eliminating the hassle 
and expense of hooking digital 
decks to a laptop. They figured that 


all you need is a USB stick packed 
with music files. “As long as there 
is low latency in both directions of 
travel, you can make effects such 
as rubbing the kick drum beats, 
scratching and backspins sound, 
feel and look realistic,” Daniel says. 
Motivated by a desire to show 
that low latency applications 
could work reliably on small and 
inexpensive ARM devices such 


The greatest challenge was 
getting the audio interfaces to 
work with low latency since many 
of the known techniques are 
for PC architecture. “Interrupt 
tweaking doesn’t work the same 
way on the ARM architecture, for 
instance,” Daniel explains, “but 
switching to newer Linux kernels 
helped a lot.” The majority of 
the work involved configuring 


Most of the setup is done with 
shell script, which is easy to hack 


as the Pi, Daniel and Chris got to 
work. They used xwax (xwax.org), 
an open-source DVS for Linux 
capable of playing MP3, FLAC, and 
AAC files, among others. “But 
because xwax isn’t easy for people 
new to GNU/Linux to set up the 
system optimally, we created a 
ready-made Debian image for the 
Raspberry Pi that is specialised 
for this one application,” reveals 
Daniel. “It means DJs don’t have 
to go through as many steps to 
get it running.” 

The pair had tested Raspbian 
images and various kernels with 
hand-soldered audio hardware to 
create the inputs and outputs that 
they needed. “Then we tried a HAT 
sound card from audioinjector.net 
and some USB audio interfaces 
which include phono cartridge 
preamplifiers. These are needed 
because the stylus on the record 
outputs a signal at a very low level, 
compared to other audio devices.” 
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and scripting various programs 
to work smoothly together with 
minimal user input. “Most of the 
setup is done with shell script, 
which is easy to hack.” 

Å screen completed the package. 
Daniel and Chris decided to use 
the official Raspberry Pi seven- 
inch touchscreen. "We wanted 
something that would be easy to 
set up,” Daniel continues, “but the 
Pi Deck works with any compatible 
screen. If you’re not using a 
touchscreen, an ordinary mouse 
can be used to click the buttons. 

A QWERTY keyboard is useful for 
searching music titles.” 

Since creating the Pi Deck last 
October, the pair have been excited 
at the level of positive feedback. 
Hearing about people using it 
across the world has been music to 
their ears. “People appreciate the 
low latency and stability,” Daniel 
concludes. “These are the crucial 
factors for any performance.” 


Put the record on 

Once Pi Deck is set up, place a control vinyl on the 
turntable, power up the Pi, and insert the USB stick. 
Waxed paper under a felt slipmat will reduce friction. 


>STEP-02 

Position the stylus 

Put the stylus on the control vinyl and use your 
hand movements to find the first beat of the record. 
Cue this via the mixer headphones or the waveform 
display in xwax. 


>STEP-03 

Scratch away 

From this point on, the control works just like an 
analogue vinyl record. You can back-cue and scratch 
the vinyl, for instance, pushing the record forward or 
in reverse. 
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» Alonso learnt 
the majority 
of his maker 
skills from 
internet videos 


> Mira went 
through 
multiple designs 
before her final 
egg shape 


> She charges via 
a small port on 
her base 


> Mira's small on- 
board camera 
can utilise face 
recognition 


> Alonso's next 
build, Lumens, 
doubles as a 
night light 


Alonso Martinez explores the ideas of interaction and individuality in 
robots, creating adorable Raspberry Pi-based characters that play and learn 


n animator by trade, 

Alonso Martinez wanted to 

take his maker skills to the 
next level. He decided to explore 
the idea of interactivity with robot 
characters by creating Gertie, Mira 
and Lumens. 

With Gertie, he was able to 
explore the idea of the ball bounce - 
a Staple in animation school, where 
students are asked to animate a 
ball, and the reaction of its surface 
when it connects with another 
object. Where Gertie excelled at 
bouncing, there was still a lack of 
the emotion and personality that 
Alonso hoped to achieve. 


Mira's blinking eyes are powered 
by two small LCD screens that 
run constant animations 


Her shape is the result of 
an exploration into shape 
science, and how we 

perceive certain features 


Mira's recent appearance on 
the YouTube Tested channel 
attracted a storm of people 
desperate to buy their own Mira 
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Mesmerising Mira 

Enter Mira. Alonso wanted to 
create a character that was not only 
aesthetically pleasing and highly 
interactive, but also able to explore 
the science behind how we perceive 
a character based on its shape and 
features. Mira’s round form is the 


Ea 


result of a study into shape science. 
Her lack of limbs and sharp edges 
creates an instantly accessible and 
pleasing character. And her eyes, 
with their mini LED screens that 
blink with their deep, somewhat 
galactic blue orbs, draw us to her 
that little bit more. 
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Mira's control circuits sit inside her egg-shaped 


body, with millimetres of space to spare 


But Mira is more than just a 
pretty face. Inside her body lies 
a Raspberry Pi, laden with code. 
Cover your face, for example, 
and Mira will recognise the game 
of peekaboo via her on-board 
camera, offering up a shocked 
squeal of excitement when you 
say “Boo!” and reveal yourself. 
Sit Mira beside you at a piano 
and she’ll sing back to you any 


Mira and Lumens build their own 
code and truly create their own 
unique identities? 


Millimetre-perfect 

Stepping back from the mind- 
blowing concepts of interactive, 
intelligent robots, the physical 
build behind Mira and Lumens is 
equally impressive. As an animator, 
Alonso is highly skilled in 3D design 


Her lack of limbs and sharp edges 
creates an instantly accessible 
and pleasing character 


note that you play, shaking her 
head like a bird from a classic 
Disney movie. And while all this 
interaction is fun and pleasing, 
Alonso is planning to take the 
build further. 


Robotic evolution 

Alonso wants to explore the 

idea of code evolution through 
interaction and play. While it’s 
cute to play with Mira ~- or her 
successor Lumens, a mushroom- 
shaped light that hides under its 
cap — what if she could do more 
with the information received? 
What if, through the unique 
individuality of the user, the 
robot created its own, similarly 
unique personality? While 
explaining the concept, Alonso 
touches on Conway’s Game of 
Life and the concept of cellular 
automation with code. Could 
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using the computer animation 
software, Maya. And it was through 
Maya that Alonso sculpted his 
robots, enabling him to recreate 
the Raspberry Pi and components, 
and measure his 3D prints to the 
millimetre. Those blinking eyes 
that give Mira so much personality 
come from two ultra-thin screens 
that slip between the two layers of 
her body. The space was so tight 
that Alonso found himself having to 
sand down solder just to make them 
fit. And as for the way her ‘head’ 
moves over several axes? He took 
the idea of the joystick he’d used as 
a child to play games and recreated 
the function using 3D-designed and 
printed parts. 

Mira and her growing family 
are constantly evolving, and we look 
forward to seeing how Lumens takes 
shape moving forward. Hands up 
who wants their own? 


With his latest creation, Lumens, Alonso aims to 
incorporate the function of a night light into the robot, 
while maintaining the ideas behind Mira 
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Editing text documents is a vital skill to learn when using a Raspberry Pi 
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--More-- 


GNU nano 2.2.6 File: release notes.txt 


2.11 
Read 203 lines 


penpteyp ~ 


File: release_notes.txt 


Updated UI changes 
Updatec nwar € 


How to extract just about any file on your Raspberry Pi 
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Archiye Action Help 


3files (1.8 GB) Overwnte existing files 
Extract files with full path 


Freshen existing files 


Update existing files 
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Tutorial 


> MIDI / USB 
interface lead 


> MIDI sound 
module 
(any type) 


A block diagram 
of the complete 
hardware setup 


Make great polyrhythmic music, generated by your Pi 


ack in The MagPi #58 we showed you our 

Hexome simulator, running on a mobile 

device and controlling a sequence. It used 
concentric rings of trigger positions, starting witha 
ring of six with each subsequent ring having six more 
trigger positions. Now we take that basic idea, run 
with it, fall over, pick up the pieces, and assemble it 
into a universal polyrhythmic sequencer. 

The basic concepts are the same, but this project 
gives us nearly unlimited flexibility. Each ring 
generates only one note, and those notes can be 
changed by mapping. However, almost everything 
else has changed. There are up to six rings in the 
sequence: each ring can have a maximum of 32 trigger 
positions, and can be individually muted. The big 
change is that each ring can have its own individual 
sound and volume, courtesy of MIDI. 


MIDI connection 

MIDI stands for Musical Interface for Digital 
Instruments. It is a very old standard, but still 
as popular as ever. MIDI is a serial interface that 


MIDI in 


MIDI out 


USB / MIDI 


MIDI Sound module 


sends messages between musical devices, which 
include instruments (like a keyboard), and sound 
modules that generate an audio signal. Some devices 
can combine the two categories in one device — the 
most popular being sound-generating keyboards. 
Messages consist of two or three bytes, and cover 
commands such as Note On and Note Off, as well as 
other controls, including volume, vibrato, echo, and 
pitch bend. 

A MIDI connection can control 16 different 
channels, where a channel can range from one voice 
or sound to a totally separate piece of hardware. 
Often instruments have a switch that determines the 
channel they transmit on, and most will default to 
channel 1. 

MIDI runs at the quirky baud rate of 31,250 baud. 
It is odd by today’s standards, but in the old days it 
was used because it was simple to generate. A MIDI 
device can have an input and an output, and, much 
to the surprise of younger people, an input must be 
connected to an output. There can also be a MIDI 
‘Thrw’ (‘through’ in English), which is simply the 


Audio in 


Amplifier & Speakers 


Audio out 


MIDI in not used 


The polyphonic sequencer controls 
are displayed on the screen 


You'll need a USB to MIDI interface box to 
allow the Pi to talk to the module 


This MIDI sound generator module is a Yamaha MU10 


signal from an MIDI input, passed to an output, 
allowing one MIDI output to talk to a number of inputs 
in a chained fashion. 

The quirky baud rate is a historic accident. At the 
time, you would have used a 1 MHz clock for your 
processor, which you simply divided by two to give 
500 kHz. This was fed directly into the UART (serial 
chip), which required a clock signal of 16 times the 
baud rate, giving you 31,250 baud. While the Raspberry 
Pi can’t support that rate directly, it can be helped 
to do so. Although this was relatively simple on 
earlier models, the Pi 3 uses the good serial port for 
Bluetooth, and the second serial port is tied to the 
clock speed - which can be variable depending on 
processor demand and temperature. The simplest 
solution is to bypass the serial port and plug in a USB/ 
MIDI lead. While these used to be expensive, today 
you can find them for less than £5. 

We also chose to use a hardware MIDI sound module 
for this project. We used the Yamaha MU10, but there 
are any number of modules that could be used - many 
available second-hand at bargain prices. There are 
many other options for this project - see the ‘Taking 
it further’ section at the end of this article. The basic 
setup we used is shown in Figure 1. 


Why MIDI? 

So why use MIDI for this project? Other projects 

we have worked on involving sound generate that 
sound by playing samples. Those samples have to be 
found, recorded and put into the appropriate files. 

If you want to use more than a handful of different 
instruments, this is a lot of work. It can also result 
in an unsatisfactory quality of sound, because you 
can’t control the individual volume, and you can 
experience audio clipping if too many samples are 
played at the same time. By using MIDI, we can leave 
the instrument or voice generation to another piece 
of hardware or software. 


Polyrhythmic sequencer 

The original Hexome was based on a hexagonal grid 
of concentric circles. This gave an inner ring of six 
positions. Around that was a circle of 12, around that 


a circle of 18, and so on. This led to a rule that any ring 
Rn has the number of positions in Rn given by: 


Rn= Rn-1 + 6 
... where Rn-1 is the number of keys in the previous ring. 

With this software, we can base the rings on any 
number, so that formula becomes: 

Rn= Rn-1 + B 
... where B is the base number of the innermost 
ring. This leads to the concept of a Triome, based on 
three positions on a ring — or a Quadome, Pentome, 
Heptome or Octome. Each of these models can be 
set up using this software. Additionally, any number 
of trigger points can be set up on a ring, up toa 
maximum of 32. For example, if each ring has the 
same number of trigger points, you have simply 
produced a conventional N step sequencer. 

The length, or number of steps before repeating, of 
any particular setup is given by the highest common 
factor of each of the rings. This is maximised in setups 
where the rings contain a prime number of trigger 
points, as this gives a sequence length of the number 
of trigger points in each ring multiplied together. 

If you start at two triggers for the smallest ring, 
this gives a staggering 30,030 steps before a repeat. 
Starting with a base of three you get even more, at 
255,255. At these sequence lengths, the result is 
indistinguishable from random sounds. 
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Figure 2 

Learn to control 
the sequencer 
and make some 
great music 
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Implementation 

To write the code, we are going to use the Processing 
language. If you haven”t already, install Processing by 
opening a Terminal window and typing: 


curl https://processing.org/download/ 
install-arm.sh | sudo sh 


You also need to install two libraries. From the 
Sketch menu, go to the import library entry and 
choose Add Library, then search for and install 
controlP5. This deals with the variable controls. 
Then repeat this and install the themidibus library. 
This is the library that will generate and send 
the MIDI messages. 

As the code is rather long, you can download it from 
magpi.cc/1NqJjmV. It is entirely operated from the 
keyboard or mouse attached to the Pi. 

The number of rings is limited to six in this 
implementation, simply because the resulting 
980x720 pixel window is all that will fit on a standard 
HD screen. If you want a seven-ring sequencer, you 
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would need a window measuring at least 1100x860 
pixels. Each ring is limited to a maximum of 32 trigger 
points, again due to the physical resolution of the 
screen. This is despite using the trick of changing the 
ring width depending on the number of trigger points. 


The Code 

The code is written in three sections, or tabs: these are 
Poly, Controls, and Note_Map. In the Poly tab, the 
line at the start: 


MidiBus.list() 
... lists all the MIDI devices that have been recognised by 
the computer, both as input and output devices. We are 
only interested in output devices, and it is likely that you 
will only have one such device plugged in. If so, the line: 


MidiBus(this, Ø, 1) 


...which selects the MIDI device to use, will not need 
to be changed. 
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Three different setups for this program 


The controls 

Figure 2 shows the screen, with an explanation of the 
controls and what they do. In order to fit round the 
circles, and to minimise the window width required, the 
controls are scattered around the outermost circle. Most 
of the controls need repeating for each ring, including 
the ring length and mute controls. Others apply to the 
whole instrument, including the speed control, along 
with the Stop/Start, Reset and Clear commands. 

The configuration controls give you some preset rings 
and trigger position numbers. These can be modified by 
the ring length controls, but it is a convenient place to 
start. The instrument controls determine the voices for 
each ring. On startup, this is set to 0, which is a Grand 


Tutorial 


Piano. For a list of which instruments correspond to 
each number, see the implementation sheet for your 
MIDI sound module. 

On the lower right-hand side of the screen is the 
MIDI channel for each ring. These can be set to the 
same channel to play all the notes with the same 
voice. Similarly, the Velocity number determines 
how hard an instrument is ‘struck’. You might like 
to think of this as a volume control, which in a way it 
is — but a good sound module will also subtly change 
the timbre of the sound as the velocity increases. 

The note mapping is controlled by the buttons 
running down the right-hand side of the window. 
This controls which notes are generated on each 
ring, as defined in the Note_Map code tab. The top 
five are arranged in thirds, ascending; whereas the 
next five are in a pentatonic scale. It is a good idea 
not to change between these in a single piece, as the 
resulting key change can be jarring. The lower seven 
mappings are simple single-note shifts in the key 
of C major. These settings can easily be changed by 
altering the code in the Note_Map code tab. Figure 3 
shows three different setups for the program. 


MIDI channel 9 


There is something special about MIDI channel 9. 
When you use this channel, for each note number 
you don’t get a change in note pitch, but a different 
percussive instrument, including cymbals, drums, 
cowbells, blocks, and whistles. With the same 
mapping as the pitched notes, it can be pot luck as to 
which instrument ends up here. 

It is possible that as you change some parameters 
on the fly, you can be left with a hanging note. This 
is anote where the sound module has received a Note 
On message, but no corresponding Note Off message. 
If you get a hanging note and want to reset it, click 
the Reset control. This sends Note Off messages to 
all possible notes on all possible channels, a process 
which takes less than two seconds. 


Taking it further 


You can extend any program. Despite its flexibility, 
this one is no exception. The most useful change 

you could make is to include the ability to save and 
load the patterns and controls you have created. 

It is just a matter of saving the appropriate arrays, 
and restoring them when you load the program. You 
also might like to have a special set of mapping that 
kicks in when the percussion channel, channel 9, is 
selected. You might want to use a soft synth as your 
sound generator — this could be on another computer, 
another Pi, or on the same Pi you are using to run the 
software. The fluidsynth and qsynth combination is 
popular on the Pi, but there are several MIDI-capable 
synthesizers out there. You could even investigate 
routing the output of this sequencer into Sonic Pi. 


DOWNLOAD: 
magpi.cc/1NqJjmV 


Check out Mike's 
Bakery videos at: 
magpi.cc/1NqJnTz 


Note the sensor 
connections to the 
header for the GPIO 


A temperature sensor is installed 
in the cork, passing through into 
the water in the bottle 


The Raspberry Pi installed on the chiller unit using Velcro 


WINE SAVER: 


ROOM TEMPERATURE MONITOR 


This project monitors the temperature of a wine storage room hourly, 
and sends an email when it exceeds an ‘alarm’ or ‘fail’ level 


Pi Zero W 


4GB (or larger) 
microSD card 


Suitable case 
for the Pi 


Waterproof 
DS18B20 
temperature 
sensor 


Stacking header 
Gmail account 


Empty wine 
bottle and a cork 
that fits it 


e have a wine storage unit in our garage, and 

over the last 20 years the compressor has failed 

twice during extreme heatwaves. We weren’t 
constantly checking the temperature display, so we 
had no warning of the impending failures, which would 
have allowed us to move the wine to an air-conditioned 
location and have the compressor repaired. This project 
provides hourly logging of the temperature, and sends 
warning emails if the temperature exceeds set limits. 


Software setup 
Download and install the latest version of Raspbian 
Jessie Lite on your microSD card. Initialise Raspbian 
with sudo raspi-config to the proper international 
options (time zone, keyboard, wireless country 
code, etc.), change the default password, and set the 
host name in advanced options to something like 
‘wineroom’. Make sure that you enable both SSH and 
1-Wire in the Interface section of raspi-config. 
Reboot (otherwise your keyboard settings may not be 
correct), and set up the wireless by editing the relevant 
config file: sudo nano /etc/wpa_supplicant/wpa_ 
supplicant.conf. Add these lines to the end. 
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network=( 
ssid="your ssid" 
psk="your password" 
key-mgmt=WPA-PSK 


Be sure to replace "your ssid" and "your 
password" with the actual values for your network, 
and keep the quotes. Now reboot again. 

Use the ifconfig command to see the IPv4 address 
that you will need to SSH into the Pi later. Write it 
down (192.168.1.27 or 10.0.0.27 are typical values). 
Now you should run the usual update and upgrade to 
the operating system: 


sudo apt-get update && sudo apt-get upgrade -y 
Next, install the mail and ssmtp applications: 
sudo apt-get install ssmtp heirloom-mailx 


Edit the ssmtp configuration file to point to your 
Gmail account as shown. Add the text below to the end 
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of the configuration file with sudo nano 
/etc/ssmtp/ssmtp.conf. 


# Wine Room Monitor settings - for gmail 
hostname=wineroom 
root=your-mail@gmail.com 
mailhub=smtp.gmail.com:587 
FromLineOverride=YES 

AuthUser=your gmail name (leave out the @ 
and stuff after that) 

AuthPass=your gmail password (no quotes 
needed here) 

UseSTARTTLS=YES 

UseTLS=YES 

AuthUser=LOGIN 


Now save the file and exit. As we will run the 
monitor program with crontab, we must also change 
the /etc/ssmtp/revaliases file or authentication errors 
will occur. So, sudo nano /etc/ssmtp/revaliases 
and add the following line: 


root: your-email@gmail.com:smtp.gmail.com:587 
Now reboot. 


The program 
Log back into the Pi. First, create a directory called 
wineroom and move into it: 


mkdir wineroom 
cd wineroom 


Download the ds18b20.c file from GitHub 
(magpi.cc/2uBzIR4) and customise it for your email 
address and your alarm temperature levels. To compile: 


gcc ds18b2Ø.c -o ds18b2Ø -Wall -std=gnu99 


Hardware setup 

Take the wine bottle cork and cut it to half its length 
with a hacksaw. Carefully clamp it and use a 14" bit 

to drill a hole lengthwise through the centre of the 
cork. Next, push the DS18B20 sensor's stainless steel 
through the cork so that it is protruding from the other 
end - this is why we cut it in half. Wetting the sensor 
may make insertion easier. Now rinse the wine bottle 
with hot water and fill it nearly full of water. Wet the 
cork and push it carefully into the bottle, then put the 
bottle on its side to check for leaks. You may need to 
add a bit of silicone to seal around the sensor. 

On the stacking header, solder a 4.7 KQ resistor to 
Pin 1 and Pin 4. Solder the sensor red wire to Pin 1. 
Solder the white wire to Pin 4; the black wire to Pin 5. 

Now plug the header onto the Raspberry Pi (make 
sure it’s off!), being careful to get the location of Pin 1 
correct. Boot the Pi up, log in, and test it with: 
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Place the wine bottle sensor below the top of the rack 


cd wineroom 
sudo ./ds18b20 & 


Look at the file in your /home/pi/wineroom directory 
called wine.log. There should be one entry. You are way 
over the temperature range and should get an email 
showing an alarm or alert. This will test whether you’ve 
got the email settings correct. If you don’t get an email 
in a few minutes, take a look at /etc/ssmtp/ssmtp.conf 
again to see whether there are any errors. 

Now we create a short script to rename the log file and 
add the year and month to the log file name at the end 
of every month. Of course, since we run it on the first 

of the month, we need last month’s date. Download 
logupdate.sh from GitHub, edit it to incorporate your 
email address, then make it executable: 


chmod +x logupdate.sh 


Next, we automate things with crontab by editing 
with sudo crontab -e and adding two lines to the 
end of the file. The first line runs the code at five 
minutes after the hour, every hour of every day, and 
the log file renaming happens at four minutes after 
midnight on the first of the month. 


5 * * * * /home/pi/wineroom/ds18b20 
401 * * /home/pi/wineroom/logupdate.sh 


Save the file, then to get the new crontab 
entries working: 


sudo service cron start 
sudo update-rc.d cron defaults 


Use some Velcro on the bottom of the Raspberry 
Pi Zero W case to attach it to the cooler unit. If there 
is no power plug inside the wine cooler, remove a 
bit of the sealant around the cooler and run a micro 
USB power cable through. Then replace the sealant to 
close the system back up, power it up, and let it run! 


DOWNLOAD: 
magpi.cc/2uBzlR4 


CREATE A 
UNIQUE GMAIL 


Create a 
brand new 
Gmail account 
just for this 
purpose. A 
unique Gmail 
account for 
the wine room 
prevents a lot 
of spam. 


USE BITVISE 


Use Bitvise 
instead of 


PuTTY (same 
developers) to 
check on the 


temperature at 
any time. 
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Tutorial WALKTHROUGH 


HENRY BUDDEN 


Following the release of the Raspberry 
Pi when he was 12, Henry taught 
himself to code and use/break 
electronics, and has shared this 
process with the world on his website. 
magpi.cc/2eCbaMf 
twitter.com/pi_tutor 


Full touch control of 


the 3D printer and 
live view of status 
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WITH YOUR RASPBERRY PI 


Climb on board the 3D printing bandwagon on a budget, using a cheap 


> 3D printer 
with updated 
firmware and 
USB connection 


> Spare microSD 
card 


> WiFi connectivity 
(USB WiFi dongle 
if needed) 


> Official 
touchscreen 


> Repetier Pro 
subscription 
(optional) 


> USB webcam 
(optional) 


but powerful printer controller with a Raspberry Pi at its core 


he rise of 3D printers has seen numerous 

inexpensive models becoming available in 

the £100-£150 bracket, but what is the best 
way to interface with them? A Raspberry Pi, of course! 
This tutorial will cover the things you need in order 
to control your already working 3D printer with a Pi, 
allowing you to have remote access and monitoring 
capabilities for your printer from anywhere in the 
world; as well as the ability to start printing, cancel, 
and tweak the settings mid-print, thanks to our 
favourite little credit-card-sized computer. 


Choosing your printer 

If you are not already lucky enough to be the proud 
owner of a3D printer, then the first step is to choose 
one to buy. There are many options on the market, 
ranging from £100 to upwards of £1,000, with 
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reliability and quality a considerable factor in these 
price differences. In an attempt to keep the cost of 
this project low, we opted for a £150 Prusa i3 clone 
new from eBay. The printer came as a kit and required 
a few adjustments, along with some Googling due to 
difficult-to-translate instructions. 

Even so, this should be easy enough for a complete 
3D printing novice. 

There are many of these clones available at a 
similar price online. If you would prefer a branded 
budget printer, you can buy a Startt printer for £99 
from imakr.com. However, it still requires building 
and adjusting, and has a smaller build volume than 
the Prusa. For larger amounts of money, the official 
Prusa 3D printers can be purchased, as well as many 
others. As this market has grown so rapidly, there are 
countless options. When buying a 3D printer for use 
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3D PRINTING WITH YOUR RASPBERRY PI 


with a Raspberry Pi, ensure that the printer has a USB 
interface and that the firmware is recent. 


Setting up the software 

Once you have built your printer by following the 
specific instructions, you should be able to print 
normally, if directly connected to a computer. You'll 
soon realise that this is a solution with very limited 
functionality, as you have to be directly connected to 
the printer in order to make any changes to it. 

To set up the software on your Raspberry Pi, head 
to magpi.cc/2vBupZw and download the OS image 
specified for the Raspberry Pi. Once you have done 
this, unzip the file and write the image to your 
microSD card. 
If you are using an official touchscreen, connect 
this to your Pi, as well as a method to connect toa 
WiFi network if needed. Once the Raspberry Pi is 
powered on, the touchscreen will display the option 
to connect to a wireless network, which is vital. Follow 
the on-screen instructions. If you are not using a 
touchscreen, you can follow a step-by-step guide to 
setting up WiFi at magpi.cc/2vBe739. Troubleshooting 
for any problems that may arise while setting up the 
internet connection and installing the OS can also be 
found here. 

You will then need to set up your printer on the 
system by inputting the type of printer, as well as 
its size, shape, and manufacturer. The process is 
fairly foolproof, and you will be guided through 
it step-by-step. 


Using Repetier software 
The majority of the following information will mainly 
apply to those using the official touchscreen to 
interface with their printer. 

Once the internet connection is set up, you will 
see a menu similar to the one shown in Figure 1. 
Navigating these menus will allow you to directly 
control the printer’s motors, as well as viewing 
network settings and sending emergency stop 


@ Dashboard 
Free Disk Space: 169.1 GB 
o 30 to Printe o 
sh Network 


Figure 1 Printer control is also accessible via the internet 
over a local connection on any device 
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The screen allows access to the printer's 
current status, as well as live settings 
changes and control of the motors 


Tutorial 


commands. One of the best features of the software is 
the fact that you can access the printer remotely via 
the local network by navigating to the Pi’s IP address 
on any device connected to the same LAN. This allows 
you to upload files to the server to be printed, as well 
as allowing you to view the progress of prints and 
cancel them. You can also view a live picture feed of 
the printer if you connect a USB webcam to the Pi. 

For a better experience, installing Repetier- 
Host (magpi.cc/2vBgS4f) on a PC will offer a more 
streamlined process that allows you to slice STL files 
and upload them directly for printing, as well as 
offering built-in direct control of your printer without 
the latency introduced by using a web browser. 


Printing 

As a beginner, it’s easy to feel intimidated by all 
the different file types and methods for printing a 
predesigned object, but there are several industry- 
standard methods that are almost always used. 

Most 3D designs from online sites such as 
thingiverse.com will be in the form of an STL file 
that contains the actual shape data of the object. 

In order to print this design, the file will need to 

be ‘sliced’, which converts the shape into exact 
instructions for the printer’s movements. Slicers 
such as Cura can be found online; however, the 
Repetier-Host software for PC contains a built-in 
slicer. By slicing the file, the software will generate 
instructions for printing based on your printer’s 
exact parameters, including its size and shape. 

Once the STL file has been sliced, a G-code file will be 
created, which can be uploaded directly to the printer 
and run in order to print the object. 


LIGHTING 


If your 
printer is in 
an enclosed 
space, 
consider 
adding some 
lighting, 

such as LED 
strips. This 
will provide 
illumination 
for the 
webcam, and 
clearer images 
for you. 


INTERNET 
CONNECTION 


A strong and 
stable internet 
connection 
is required in 
order to run 
the printer 
successfully. 
If the 
connection 
is weak, 
consider 
connecting 
the Pi via 
Ethernet. 
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LIVE-CODING 
ONLINE WITH 


ONIC PI 


Share your live-coding performances with listeners anywhere 
on the internet using Sonic Pi, some simple Python code, and MQTT 


Paho MQTT 
Python Client 
magpi.cc/ 
2vB4txx 


Ruby 
ruby-lang.org 


sonic-pi-cli 
magpi.cc/ 
2vBhoze 


Below Start the 
publisher to send 
the Sonic Pi code 


so E70 


Weee - 
pun 


TD €D CD €D ED 


riginally created as an interactive and 

fun instructional tool for teaching both 

programming and music, Sonic Pi is also a 
very powerful tool for creating sophisticated live 
performances as well as algorithmic compositions, 
all by writing code. It’s perfect for people who love 
to code and love to create music, even if they can’t 
play an instrument. Best of all, Sonic Pi is included 
in Raspbian, making it easy to get started with 
coding your own musical creations on your Raspberry 
Pi. Wouldn’t it be great if you could share those 
creations over the internet? In this project, we’ ll 
show you how! 


Bonn 
~*~ 
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Sharing Sonic Pi compositions 

For this project, we will assume that you are at least 
somewhat familiar with the Sonic Pi GUI and its 
coding language, and you have at least tried some 
simple code or played with the many examples 
included with Sonic Pi. If not, check out the Essentials 
book, Code Music with Sonic Pi, for some excellent 
beginners tutorials: magpi.cc/1VGIOux. 

Our goal for this project is to give you a way to 
go beyond playing your Sonic Pi compositions for 
whoever happens to be in the room with you. We’ll 
show how you can share your Sonic Pi coding creations 
with your friends, family, and fans over the internet, 
so they can listen to your musical masterpieces 
virtually anywhere in the world. 

To do that, we have created a couple of simple 
Python programs that can interface with Sonic Pi, and 
communicate with each other over the internet, using 
a lightweight IoT messaging protocol called MQTT. 

MQTT is a publish/subscribe messaging transport 
protocol (in case you are wondering, MQTT originally 
stood for MQ Telemetry Transport, but is no longer 
officially an acronym). It was designed to be 
very lightweight, simple and easy to implement 
and is most commonly used for communication 
in machine-to-machine and Internet of 
Things applications. 
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MQTT 
Publisher 


Python program 
reads the saved 
Sonic Pi code and 
publishes to an 
MQTT broker 


The main aspect in the publish/subscribe pattern 
is the decoupling of publisher and receiver, where 
the publisher and subscriber don’t know about the 
existence of one another, don’t have to run at the 
same time, and are not halted during publishing or 
receiving. A third component, a broker, is known by 
both parties: this filters and distributes all incoming 
messages by subject/topic. 

For this project, we have created two Python 
programs that use the Eclipse Paho MQTT Python 
client library to implement an MQTT publisher and 
subscriber. The programs use the public Eclipse IoT 
MOTT broker at iot.eclipse.org to exchange messages. 

The publisher program, sp-mqtt-publisher.py, 
is used to read a file that contains Sonic Pi code, 
and publish it to the Eclipse IoT MQTT broker. The 
subscriber program, sp-mqtt-subscriber.py, is then 
used to retrieve the Sonic Pi code from the broker and 
send it to Sonic Pi for playback. 
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MQTT 
Subscriber 


Python program 
receives Sonic 

Pi code from the 
MQTT broker and 
sends to Sonic 

Pi CLI 


— 


Sonic Pi CLI 


Sonic Pi CLI connects 
to the Sonic Pi server 
to play the received 
Sonic Pi code 


Getting started 

To get started, first download the two included Python 

programs, sp-mqgtt-publisher.py and sp-mgtt- 

subscriber.py, and save them on your Raspberry Pi. 
Next, you will need to install the Python MQTT 

client library from the Eclipse Paho project. This 

is easy with the Python package manager, called 

pip, which is included with Raspbian Jessie. Open a 

Terminal window on your Raspberry Pi and enter the 

following command: 


sudo pip install paho-mqtt 


Finally, you will need a way to send Sonic Pi code 
directly to the Sonic Pi synth server, rather than 
typing it into the Sonic Pi GUI. Currently, there is 
no built-in capability to play your compositions 
on Sonic Pi from the command line - although that 
is apparently planned for Sonic Pi 3. Consequently, 
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Tutorial WALKTHROUGH 


Right Save the 


composition from 
the Sonic Pi buffer 


to a file, so the 
Python publisher 


program can read 


52 


t and publish it to 
the MQTT broker 


MEGET 


le Li Jøss 


EB vicrescberypi-~] [asaye curent autier | 
ee aoo 

N SADAR 

. 


# Tron Bike 2e 
Mono 


2%|1412 


# Coded by Sam Aaron 


use. random, see Me 


notes = (ring name [won-bike va } 


live loop :tron Saveinfoider |< (Bipi Create Folder 

with synth :d: ] 

with_fx(:sl v J 
with_fx(: earch “pn 


nl = (cl 
n2 = (ct 


n = nla 


# Coded by Sam Aaron 


use_random_seed 10 
notes = (ring :bl, :b2, :el, :e2, :b3, :e3) 


we are using sonic-pi-cli, written by Nick sonic_pi "sample :loop_breakbeat" 

Johnstone (magpi.cc/2vBhoze). This provides 

a very simple command-line interface, written You should hear the breakbeat sample loop that is 

in Ruby, for interacting with Sonic Pi. Luckily, included with Sonic Pi. 

Ruby also comes as part of the Raspbian Jessie With that working, now it’s time to try a simple 

distribution, and sonic-pi-cli should work just live-coding performance over the internet, using the 

fine with it. From the Terminal window, enter the two Python programs provided. With Sonic Pi open, 

following command: copy one of the code examples included with Sonic Pi 
into a buffer. Then, using the Save button, save the 

sudo gem install sonic-pi-cli buffer to a file. In the screenshot, we have chosen the 


tron-bikes example because, well - who doesn't like 
the sound of Tron light cycles? 


Now it’s time to try a simple Once the buffer is saved to a file, run the sp-mqtt- 


publisher.py program from a Terminal window. You 


: E ; will need to include two command-line arguments 
live coding performance when you run the program. The first specifies the 


MQTT topic name that you will publish to. Choose 


Over the inte met something that is simple and likely to be unique. The 


second argument is the name of the code file in which 
This will install a Ruby script, called sonic_pi, inthe you saved the buffer from Sonic Pi. For example, you 
/usr/local/bin directory on your Raspberry Pi, where it might enter the following command: 
can easily be called from the Python code. 
python sp-mqtt-publisher.py saulpimon 


Try it out! tron-bike.txt 

Once you have these components installed, 

it’s time to try everything out. First, let’s make The publisher program will read the contents of the 
sure that the sonic pi Ruby program is working. code file named on the command line, and publish 
Start by opening Sonic Pi. Once the Sonic Pi GUI it to the Eclipse IoT MQTT broker under the provided 
is running, open a Terminal window and enter the topic name. The publisher program runs an infinite 
following command: loop, and every ten seconds will re-publish the code 
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# Coded by Sam Aaron 


use_random seed 10 
(ring :bl, :b2, :el, :€2, :b3, :e3) 


notes = 


Above The saved file will be published to the MQTT broker 


to the MQTT broker. With each iteration of the loop, 
it will check to see if the code file has been updated 
and, if so, it will re-read the file before re-publishing, 
so that the most recent version of the live-coding 
composition is published to the MQTT broker. 

Now, of course, this isn’t much of a live-coding 
performance without listeners, right? If you have 
a couple of friends who want to help, you can have 
them install the required components as described 
in the ‘Getting started’ section, and run the Python 
subscriber program, sp-mqtt-subscriber.py, to 
retrieve the published code from the MQTT broker and 
play it using Sonic Pi on their own Raspberry Pi. Or, if 
you like, you can run the subscriber program yourself 
on the same Raspberry Pi that you used to publish the 
code. To run the subscriber program, first be sure you 
have installed the Paho MQTT client and the sonic_pi 
Ruby script as described above. Next, open Sonic Pi 
and run the Python subscriber program, being sure to 
specify the same topic name that was used with the 
publisher above as a command-line argument. For 
example, enter the following command: 


python sp-mqtt-subscriber.py saulpimon 


[he subscriber program will connect to the Eclipse 
IoT MOTT broker and retrieve messages that are 
published to the topic named on the command line. 
When a message is received, the subscriber program 
then calls the sonic_pi Ruby script, passing the 
retrieved message as data. The sonic_pi Ruby script 
connects to Sonic Pi and sends it the code, which will 
then be played. Don’t worry when you don’t see the 
retrieved code in the Sonic Pi GUI on the Raspberry Pi 
on which you’re running the subscriber program. The 
sonic_pi Ruby script doesn’t interact with the Sonic Pi 
GUI at all. Instead, it connects directly to the Sonic Pi 
synth server to send the code. 

You are now ready to start sharing your live-coding 
masterpieces over the internet. Simply make changes 
to the Sonic Pi code as you would with any other 
live-coding performance, and save the buffer to a 
file as described above. The simple Python programs 
and MQTT will handle the rest, for you and your 
faithful listeners! 
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>PYTHON 


rpmgtt-publisher.py 


import paho.mqtt.client as paho 
import time, os, sys 


DOWNLOAD: 
magpi.cc/2vB5FRx 


topic = sys.argv[1] 
filename = sys.argv[2] 


host = "iot.eclipse.org" 
client = paho.Client() 
client.connect(host, 1883) 
timestamp1 = -10 
while True: 
timestamp2 = os.path.getmtime(filename) 
if timestamp1 != timestamp2: 
with open(filename, 'r') as myfile: 
filedata=myfile.read() 
timestamp1 = timestamp2 
client.publish(topic, filedata) 
time.sleep(10) 


rpmgtt-subscriber py 


import paho.mqtt.client as paho 
import sys, subprocess 


def on_message(client, userdata, message): 
pipe = subprocess.Popen("sonic_pi", stdin=subprocess. 
PIPE, shell=True) 
pipe. communicate(input=message. payload) 
print(str(message.payload.decode("“UTF-8"))) 


def on_disconnect(client, userdata, rc): 
subprocess.call("sonic_pi stop", shell=True) 


topic = sys.argv[1] 

host = "iot.eclipse.org" 
client = paho.Client() 
client.connect(host, 1883) 


client.subscribe(topic, ©) 


client. 
client. 


on_message = on_message 
on_disconnect = on_disconnect 


print("Press Ctrl-C to stop...") 
EEY: 
client.loop_forever() 
except KeyboardInterrupt: 
client.loop_stop() 
client.disconnect() 
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PIHUE 


Pimoroni 
Touch pHAT 
magpi.cc/ 
2pafoP9 


Philips Hue 
Bridge and Lights 
magpi.cc/ 
2uBNFsK 


phue Python 
library by 
Studiolmaginaire 
magpi.cc/ 
2uBWOBF 


Below The PiHue, 

with Touch pHAT 
and custom laser- 
cut cover to show 
the colour options 


CONTROL 
PHILIPS 
HUE LIGHTS 


Learn how to control Philips Hue lights with a Raspberry Pi 


and the Pimoroni Touch pHAT 


e’re all guilty of spending too much time 

geeking out! GeekyTim is no exception; he 

spends his time in ‘Hut 8’ (his log cabin in the 
garden) tinkering with Raspberry Pis, 3D printing, and 
laser cutting. His wife complains when she has to come 
out in the rain to call him in! 

After buying some Hue lights, he wondered whether 
they could be controlled with a Pi. Philips provides APIs, 
and other Python libraries have been developed to access 
the Bridge. So, he put them all together and created the 
PiHue — a Raspberry Pi Zero W with Touch pHAT that his 
family can use to call him in from play... 


Setting up 
We start by connecting our Pimoroni Touch pHAT to 
the Pi, burning the Raspbian Jessie Lite image onto 

an SD card, booting up, and connecting to the same 
network that the Hue Bridge is on. 

We need to install a few prerequisites before 
downloading the PiHue code, including Python 3, pip, 
Git, the Touch pHAT library, and the phue library that 
gives us access to the Hue lights from Python: 


sudo apt-get update 

sudo apt-get install python3 python3-pip git 
sudo apt-get install python3-touchphat 

sudo pip3 install phue 
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Next, we need to download the PiHue code 
from GitHub: 


git clone https://github.com/GeekyTim/PiHue 
The PiHue code is in the PiHue directory: 


cd PiHue 


Configuring PiHue 

Each of the Touch pHAT's six capacitive buttons 

will have a different function. The Back (left arrow) 
button turns the lights on and off; four A, B, Cand D 
buttons flash the lights red, yellow, green, and blue 
respectively; and Enter (right arrow) makes them 
all bright. 


There are two versions of the code: 
> PiHueRoom.py controls a Room as defined 
in the Hue app. 
> PiHueLightList.py controls individual lights in a list. 


The Room version works best with a room that 
contains more than one light, especially if one is 
coloured and one is dimmable. 


We have to edit the code to make some changes 

for our Hue setup: 

> Set the IP address of the Philips Hue: bridgeip. 
We can find this by accessing our router’s IP 
address list or using a network sniffer tool. The 
Bridge’s MAC address can be found in the Hue app. 

> For PiHueRoom.py, set the name of the room to 
be controlled: roomname. 

> For PiHueLightList.py, change the names of the 
lights in the Python list: lights. 


Optionally, we can change the list of Hue xy 


colours by adding to those already listed under 
the comment # Hue 'xy' colours. 
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Above It's alive! 


We can also change the alert patterns in the section 
following # Alert Patterns. These are Python lists; 
the first number is how many times to repeat the 
pattern. The second is the delay between changes — 
the recommended minimum delay is 0.4 (seconds). 

The remaining values are Python dictionaries of the 
light status changes. 

Use any valid Hue status, e.g. on, bri, xy, ct, 
sat, hue, transformationtime (see the Hue API 
for details: magpi.cc/2vEpXfH). 

Dimmable lights do not accept any of the colour 
changes (xy, ct, sat, hue), so just change their 
brightness instead. 

We can specify as many changes as we want. 

For Light Lists, the status changes are Python 
dictionaries that contain the changes for each light 
type (e.g. Extended color light and Dimmable 


light). Other light types can be added if you have them 


(e.g. Color Light, Color Temperature Light). 

There is one special dictionary that is used by the 
Touch pHAT’s Enter button to set all lights to bright 
white: allwhite. We could redefine this to bea 
preferred colour and brightness. 


Running the code 

The line # b.connect() must be uncommented the 
first time the code is run. Just before running it, we 
must press the Bridge connect button. Run with: 


python3 PiHueRoom. py 
...OT: 
python3 PiHueLightList.py 

The Pi should connect to the Bridge and save the 
Bridge details in the file /home/pi/.python_hue. 
If we ever need to change the Bridge, we just need 


to delete this file. We can now re-comment the 
b.connect() line by adding # at the front.. 
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Running on boot 

There are a few ways to run Python code when 
the Raspberry Pi boots. A good method is to 
use systemd. In this case, we need to create a 
configuration file (aka a ‘unit’ file) that defines 
a new systemd service: 


>PYTHON 3 


NAME: 
PiHueRoom.py 
PiHueLightList.py 


DOWNLOAD: 


sudo nano /lib/systemd/system/PiHue.service Muun 


...and type in the following (replacing PiHueRoom. py 
with PiHueLightList.py if required): 


CONTROL 
; YOUR OWN 
[Unie] WORLD! 
Description=PiHue Service 
After=multi-user.target Don't just use 
the code as 
Å is - why not 
[Service] experiment 
Type=idle and Hen 
User=pi your lights 


match your 
own colour 
schemes? 


Restart=always 
ExecStart=/usr/bin/python3 /home/pi/PiHue/ 
PiHueRoom. py 


[Install] 
WantedBy=multi-user.target 


Exit and save using CTRL+X, Y, then ENTER. 
The permission of the unit file needs to be set to 644: 


sudo chmod 644 /lib/systemd/system/PiHue. 
service 


We need to instruct systemd to start the service 
during the boot sequence: 


sudo systemctl daemon-reload 
sudo systemctl enable PiHue.service 


When we reboot the Pi, the PiHue service should run. 


Check service status 


We can check the status of the PiHue service using: 
sudo systemctl status PiHue.service 
The last line should look like: 


Jul 10 23:26:52 PiHue systemd[1]: Started 


Start the Touch pHAT Hue controller. 
5 LIGHT 


CHANGES 


For rooms with 
both dimmable 


Sometimes the Raspberry Pi disconnects from 
the network, especially when using WiFi. Once 
disconnected, it will remain disconnected unless the 
interface is restarted or the Pi is rebooted. That makes 
this light switch a bit useless. But help is at hand: we 
can reboot the Pi if it cannot see your home router! 

Follow the instructions by Thijs Bernolet on his blog 
to enable reboot on network loss: magpi.cc/2uCoiny. 


and coloured 


lights, alter 
the brightness 
as well as 

the colour of 
the room. 
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YOUR QUESTIONS ANSWERED 


FREQUENTLY 
ASKED QUESTIONS 


USING RASPBERRY PIS 
WITH OTHER DEVICES 


PCs 

The Raspberry Pi plays well with PCs (running 
Windows or Linux) and Macs in the same way 

any other computer would — you can set it up to 
view folders and files over the network, and it can 
read all the files from a PC as long as it is running 
compatible software. 


Smartphones and tablets 

Depending on your device, you should be able to connect 
it to the Raspberry Pi to view the contents of its storage, 
in the same way that you would plug the device into a 
PC. Internet tethering over USB can also work, but you 
will need to look up the specific guides for your devices. 


Other Raspberry Pis 

As the Raspberry Pi is a fully functional computer, it 
will interact with another Pi in the same way it would 
interact with a PC or Mac. Many people use multiple 
Raspberry Pis in media setups in their homes, with 
one Pi hosting media files while another Pi plays 
them on a TV or speakers. 


What is a microcontroller? 

A microcontroller is a small piece of electronics 
that, while limited in its function, can be powerful 
enough to control lights, motors and so on with a bit 
of programming. The benefit of a microcontroller 
over a Raspberry Pi is that they typically require 

less power to run. 


Arduino 

Popular tools for creating very small computerised 
projects, Arduinos are cheap and usually use a lot 
less power than a Raspberry Pi. You can find HATs 
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NEED A 
PROBLEM 
SOLVED? 


Email magpi@raspberrypi.org or 


find us on raspberrypi.org/forums 
to feature in a future issue. 


Your technical hardware and software problems solved... 


and another add-ons that enable you to connect a 
Raspberry Pi with, and even program, an Arduino. 


Skip the microcontroller 

If power isn’t a problem for you, you can usually 
perform the tasks a microcontroller could do using 
the Raspberry Pi. There’s a huge range of HATs and 
other Pi add-ons that offer extra functionality, such 
as motor control, environment sensing, and even 
higher-quality audio output. 


Controlling electronics 

The Raspberry Pi on its own can control other electronic 
items if you wire them up correctly to the GPIO pins. 
The most basic function is to sense and send on and off 
signals, which could be used to control a game using 
the buttons on an old video game controller. 


Correct components 

Not every project can be made using the Raspberry 
Pi on its own. You may need to use components such 
as thermometers, microphones, light sensors, and 
analogue-to-digital converters. 


Be careful! 

Hacking an existing product may not always work - 
in fact, you may break it or the Raspberry Pi beyond 
repair! Make sure you’ve fully researched your project 
and looked up guides and instructions for similar 
projects before starting yours. 


= 
Pork os 
at 


xm 


ARDUINO 


Above Raspberry Pi can play nicely with microcontrollers 
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FROM THE RASPBERRY PI FAQ 
RASPBERRY PI.ORG/HELP 


WHAT ARE THE DIFFERENCES BETWEEN MODELS? 
The Model A+ has 512MB RAM (as of August 2016: earlier 
models have 256MB), one USB port, 40 GPIO pins, and no 
Ethernet port. The Model B+ has 512MB RAM, four USB Raspberry Pi 


BCM2835 700MHz 512MB 1 No No 
ports, 40 GPIO pins, and one Ethernet port. Model A+ 
The B+ was superseded by the Pi 2 Model B. The Pi 2 Raspberry Pi 
originally used a 900MHz quad-core ARM Cortex-A7 CPU Model B+ BCM2835 700MHz 512MB 4 Yes No 


with 1GB RAM. Some recent versions of the Pi 2 (v1.2) now 
Raspberry Pi BCM2836 or 


use a 900MHz ARM Cortex-A53 CPU. 2 Model B BCM2837 900MHz 1GB 4 Yes No 
The Pi 3 Model B was launched in February 2016. It uses 
a 1.2GHz 64-bit quad-core ARM Cortex-A53 CPU, has 1GB Raspberry Pi BCM2837 —1200MHz 1GB A Yes Yes 
RAM, integrated 802.11n wireless LAN, and Bluetooth 4.1. 3 Model B 
The Pi Zero and Pi Zero W are half the size of a Model A+, Raspberry Pi 
with a 1GHz single-core CPU and 512MB RAM, mini-HDMI Zero BCM2835 1000MHz 512MB 1 No No 
and USB On-The-Go ports, and a camera connector. The 
Pi Zero W also has integrated 802.11n wireless LAN and ree ki BCM2835 1000MHz 512MB 1 No Yes 


Bluetooth 4.1. 


KEEP MULTIPLE 
PROJECTS IN 
ONE PLAGE 


WD PIDRIVE FOUNDATION EDITION 
MADE FOR RASPBERRY PI 


Our custom NOOBS software enables you to install 
multiple work spaces for up to 5 projects that can all be 
managed from the WD PiDrive. 


CHOOSE THE 
STORAGE THAT'S 
RIGHT FOR YOU: 


USB FLASH 64GB 


Includes microSD™ card 
with starter software 


$18.99 


USB HARD DRIVE 
250GB / 375GB 


Includes microSD™ card with starter 
software and WD PiDrive Cable 


Starts at $28.99 


© WD LABS Learn more at wdlabs.io/mp60b 


Western Digital, WD, the WD logo, WDLabs, and the WDLabs logo are registered trademarks or trademarks of Western Digital Corporation or its affiliates in the U.S. and/or other countries. Raspberry Pi is a trademark of the Raspberry 
Pi Foundation. microSD is a trademark of SD-3C, LLC. All other marks are the property of their respective owners. As used for storage capacity, one gigabyte = one billion bytes. Total accessible capacity varies depending on operating 
environment. Product specifications subject to change without notice. Pictures shown may vary from actual product. © 2017 Western Digital Corporation or its affiliates. 


FOLLOW MISSIONS 


LEARN PROGRAMMING — 
ev 
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Cie ER 


Special $10 MagPi coupon: 


only at BuildPiper.com 


“Its a really fun educational computer kit 
that should really impress those who love 


Minecraft and building stuff” Mi P 
ägPi 


Want to learn how to bring Piper to your school? 


buildpiper.com/EDU 


=] Ai: 
SOFTWARE-BASED CURRICULUM | CREATE YOUR ELECTRONICS 


Supported by Top University Funds 
; i Stanford-StartX Fund 


AEF of Princeton University 


Available at: 
[PE] 
BuildPiper.com amazon ysu BARNES & NOBLE 


en È 


“ARDUINO 
RASPBERRY PI 


Combine the ease and accuracy of Arduino with the advanced capabilities 
of a Raspberry Pi for the best in physical computing projects 


f you want your next project to break beyond 
@ the limits of code and screens, you might want 

to consider adding an Arduino board to your 
Raspberry Pi. These simple, cheap controllers come in 
all shapes and sizes and allow you to easily measure, 
monitor, and manipulate the physical world. 

Arduinos are microcontrollers that make physical 
computing projects quick and easy to build. Whether 
you’re flashing LEDs, activating motors, or sensing 
changes in the real world, an Arduino is worth 
considering as part of your project. 

This tutorial will take you through the first steps 
of using an Arduino, and provide examples of fun 
and useful projects to make. Whether you’ re building 
a weather station, constructing a robot, making an 

© alarm for your bedroom, or planning an automatic 
watering system for the greenhouse, Arduino and 
Raspberry Pi make a powerful tag team. 
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ARDUINO UNO 


The Arduino Uno looks like a smaller 
Raspberry Pi board, but works 
differently. While the Raspberry 

Pi is a versatile computer, the 
Arduino board is a highly 

focused microcontroller. 


RESET BUTTON 
On one corner of 

the Arduino board 
sits a reset button 


USB TYPE B 

The larger USB Type 

B connector on the 
Arduino is used to draw 
power, and provides a 


connection between 
the Raspberry Pi 
and Arduino 
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Feature 


DIGITAL 1/0 
The Arduino has 14 digital 
input/output pins (female 


header) of which six can be 
used as PWM (pulse-width 
modulation) outputs to control 
devices such as servos, RGB 
light levels, and other devices 
that need precision 


MICROCONTROLLER CHIP 
An ATmega328P microcontroller 
is used to control the hardware 
on the Arduino board. It 

is programmed using the 
Arduino IDE (accessed via the 
Raspberry Pi) 


ANALOGUE INPUTS 

On the lower half of the Arduino 
Uno are six analogue input pins 
(female header). These can be 
used to read information from 
devices such as potentiometers 
and photoresistors 


QUARTZ CRYSTAL 
A16MHz quartz crystal 
chip is included on the 
board. This helps the 
Arduino control devices 
with precision 


Use one of the USB Type A ports 
on the Raspberry Pi to provide 
power to the Arduino. You'll 
need a USB Type A to B cable 
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CLIVE WEBSTER 


A professional tinkerer since 2004, 
Clive just keeps seeing more uses for 
Pi around the house - how many Pi 
boards is too many? 
twitter.com/clivewriting 


ARDUINO 


ow you know what an Arduino is, you’ ll want 

to discover how to connect it to a Raspberry Pi 
and use it. We’re using an Arduino Uno witha 
Raspberry Pi 3 for this guide, but the steps are similar 
for all models. 


The first step in programming an Arduino board is You will find Arduino IDE under Menu > 
to install the Arduino IDE (integrated development Programming. Open the app to start programming your 
environment) on your Raspberry Pi. This program Arduino board. 
checks code and loads it onto the Arduino. Install the 
latest version of Arduino IDE using apt: SKETCH YOUR IDEAS 


Arduino programs are called ‘sketches’, and are based 
on the C programming language. Open the IDE and 
you’ll see a blank sketch, with the two basic areas for 
code: void setup() and void loop(). If you see an 


Alternatively, open Chrome on your Raspberry Pi, empty script, choose File > Examples > 01. Basics > 
head to magpi.cc/2tPw8ht, and click the Linux ARM link  BareMinimum. 
under ‘Download the IDE’. Extract the file to your /opt As the comments explain, void setup() is for code 
directory , then open a Terminal and run the install.sh that runs once to set up your electronics properly. The 
script to install. code you type into void loop() will repeat from the 
Power the Arduino first line to the last in an endless loop. 
fromone or er To demonstrate, we’ve written a basic sketch that 
USB ports; this also 
enables two-way flashes two LEDs when you move your hand over a PIR 
Aa ‘ ~ um comminEation sensor. Connect the two LEDs and PIR sensor to the 
Arduino, as shown in the circuit diagram (Figure 1). 


Once you’ve wired up the Arduino to the circuit, attach 
Use the digital it to one of the Pi’s USB ports. This provides power 
GPIO pins of the to the Arduino, as well as a data connection between 
herde nies your Raspberry Pi and the Arduino board. Do not use 
the Arduino’s barrel-jack power input — a Pi 2 or 3 can 
supply enough power for an Arduino board over USB. 
-_—------_-——-— Enter the code from PIRBlink.ino and save it as 


Arduinos have PIRBlink using File > Save. It will be saved inside the 
specific inputs to A A : : 
SSeS receive analogue Arduino directory in your Os directory. l 
KG information from We use the pinMode instruction to tell the Arduino 
zé ouen COMET” e || devices such as our which GPIO pins the LEDs are attached to (pins 5 and 6) 


_— PIR motion sensor 


and that each pin should be treated as an output. 
Inthe void loop() section, we tell the Arduino to 
raise the voltage on these pins to HIGH (5 V) with the 


YOU'LL ARDUINO UNO LEDS RESISTORS RESISTOR CALCULATOR | PIR MOTION SENSOR 
NEED magpi.cc/2tPLngE | magpi.cc/2tPT7sU | magpi.cc/2tPNye1 I magpi.cc/2tPynl9 magpi.cc/2diJivg 
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ARDUINO RASPBERRY PI 


Figure 1 Circuit diagram 


Wu Æ AA AA 


Arduino 


The motion sensor 
requires 5 V to run, but 
outputs either 0 V (no 
motion) or 3.3 V (when 

motion is detected) 


digitalWrite instruction, then to pause for half a 
second, and then to turn off the LEDs. 

Before uploading your sketch to the Arduino, tell 
the IDE which Arduino board you’re using by opening 
Tools > Board. Then tell the IDE which port to use to 
upload your code by opening Tools > Serial Port and 
selecting /dev/ttyACMo. On version 1.8.3 of the IDE, 
you need to select the version marked ‘(Arduino/ 
Genuino Uno)’. 

Now click Upload to program the Arduino with your 
sketch. After a few seconds of code-checking and 
uploading, you should see your LEDs flashing whenever 
you move your hand over the sensor. 


LOOKING AT THE CODE 
While not necessary, it’s also good Arduino sketch 
etiquette to include a description at the start. 

At the top of your sketch, type /* and hit ENTER: the 
IDE will add two more lines. Anything written between 
the /* and */ will be ignored by the Arduino, but can be 
read by any humans wanting to understand what your 
sketch does and how it works. 

We’ve used variables for our LEDs, meaning that if 
we change the GPIO pins they’re attached to, we’ll have 
fewer edits to make. 

We tell the Arduino IDE the type of variable, then the 
name, and the value. So our LED pins are int ledi=5;. 
By replacing all instances of 5 with led1, any changes 
to our build require only one change to our code. 


ADD MOTION 

We've also added a PIR (passive infrared) motion 
sensor, as shown in the circuit diagram (Figure 1). 
We therefore declared the variable int motion = 3 
and added this line to void setup(): 


pinMode(motion, INPUT); 


Finally, we added some code to make the motion 
sensor trigger the LED flashes: 


if (digitalRead (motion) == HIGH) { 
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Feature 


Connect the Arduino 
to your Raspberry Pi 
using the USB socket 
(after you have set up 
the rest of the circuit) 


PIRBlink.ino 
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/* 
* Blinks two LEDs when motion detected 
SY 


//variables 

int led1 = 5; 

int led2 = 6; 

int motion = 3; 

int wait = 500; //500ms = 1/2s 


void setup() { 


// put your setup code here, to run once: 


pinMode(led1, OUTPUT); 

pinMode(led2, OUTPUT); 

pinMode(motion, INPUT) ; 
} 


void loop() { 


E E E O 
eeereoeee ee eee JE 
OT DE 
een paren 


// put your main code here, to run repeatedly: © 


if (digitalRead(motion) == HIGH){ 

digitalWrite(led1,HIGH) ; 
digitalWrite(led2,HIGH) ; 
delay(wait); 
digitalWrite(led1, LOW) ; 
digitalWrite(led2,LOw) ; 
delay(wait); 

} 


As with the if statement, this is part of the 
void loop() section that will run continuously, 
meaning the motion sensor will be read — or polled — 
repeatedly for signs of motion. 

A final note on coding with Arduino: every line of code 
must end with either a semicolon or a curly bracket. The 
IDE will highlight any line of code that suffers an error, 
and typically it’1l be because the previous line lacks its 
semicolon terminator. 

If you are unfamiliar with the C programming 
language, there are lots of resources you can find online 
to learn how to use it. 


LEARN TO 
CODE WITH C 


Arduino uses the 

C programming 
language. To get 

up to speed with C, 
read our Essentials 
Guide: Learn to Code 
with C. 

magpi.cc/ 
learn-c-book 


Magri 


å Raspberry Pi 
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GET THE 


RASPBERRY PI 
AND ARDUINO 


SerialLightsRespond.ino 
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* Blinks LEDs when motion detected. 

* LED blink repetition determined 

* by amount in serial_respond_pi_side.py 
Å] 


//variables 

int led1 = 5; 

int led2 = 6; 

int motion = 3; 

int wait = 500; //5ØØms = 1/2s 


void setup() { 
// put your setup code here, to run once: 
pinMode(led1, OUTPUT); 
pinMode(led2, OUTPUT); 
pinMode(motion, INPUT); 
Serial.begin(9600); 

y 


void loop() { 
// put your main code here, to run repeatedly: 
if (digitalRead(motion) == HIGH) { 
if (Serial.available()) { 
flash(Serial.read() - '@'); //Converts 
Serial message into a number 
} 
} 
delay(509); 
} 


void flash(int repetitions) { 
for (int i = 0; i < repetitions; i ++)( 

digitalWrite(led1,HIGH) ; 
digitalWrite(led2,HIGH) ; 
delay(wait); 

digitalWrite(led1, LOW) ; 
digitalWrite(led2,LOw) ; 
delay(wait); 
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TO CHAT 


Now that we can program an 
Arduino with a Pi, let’s get the 
two talking to each other 


t is possible to make commands from the Pi 
(automated or human -activated) affect the 
sketch loaded onto an Arduino; and for data 
collected by the Arduino to be sent automatically to 
the Pi to be processed. 

By why would you want to? It’s a fair question, as 
the Pi has plenty of GPIO headers to attach motors, 
sensors, LEDs, and other devices - why add the 
complication and expense of a second board? 

The answer lies in the simplicity of an Arduino 
board. It’s an easily programmable microcontroller 
with clearly labelled GPIO pins. An Arduino board 
therefore has very little overhead to prevent it from 
taking millisecond-accurate readings, and there’s 
nothing much to go wrong and cause an Arduino to 
stall or hang. 

The Raspberry Pi, meanwhile, has all kinds 
of hardware and software overheads - from 
USB controllers and display outputs to wireless 
connections and a full-blown operating system. All of 
these can lead to delays or jitters in measurements. 

Most Arduino boards have analogue inputs, and can 
supply a wide range of voltages rather than the 3.3 V 
or 5 V that a Pi offers. This makes it much easier to 
connect and code for many electronic components. 


SERIAL COMMUNICATIONS 

The standard method of communication between a Pi 
and an Arduino is serial: it’s robust, simple, quick and 
easy. Let’s start with the Arduino, turning our basic 
sketch into an alarm system. 

First, re-save the PIRBlink file, renaming it 
SerialFlashLights. Now, we need to enable serial 
communication, so we head to the end of the void 
setup() section and add: 


Serial .begin(960@0) ; 
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The capital S is required (serial. begin() won’t 
work, so the instruction won’t turn orange), while 
the number sets the speed. Serial connections are 
measured in baud, with a typical speed of 9600 baud, 
or 9,600 bits per second. 

Next, we need to set up some way of outputting 
data from the Arduino over this newly opened serial 
communication. This is fairly easy: just add the line 
Serial.println (message); inthe void loop() 
section. The classic message would be hello world, 
but we can skip straight to something more useful 
with the line: 


Serial.println ("Motion detected!"); 


We can even test that new code without having to 
write any code for Pi just yet. Upload the sketch to the 
Arduino and then click the Serial Monitor button at 
the top right-hand side. You should see the ‘Motion 
detected!’ message whenever you wave your hand at 
the sensor. 


ARDUINO TO PI 

Now we can switch to writing a Python script on 

the Pi. We’ll use Thonny, the new Python IDE for 
Raspbian. If you haven’t got Thonny yet, install it with 
this code: 


sudo apt-get update && sudo apt-get install 
thonny 


Once installed, fire up Thonny. Enter the code from 


SerialFlashLights.ino into Arduino IDE and serial_ 
flash_lights_pi_side.py into Thonny. Make sure you 
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Fle ES: View Run Tools 
Uggs > TUO 
serei respond. pusdepy* 

laport seriat 


Serkstheg = sortat Sorini ( savet 


Left The Arduino 
sketch (on the left) 
includes a serial 
read function that 
gets data from the 
Python code (on 
the right) 


Most Arduino boards have analogue inputs, 
and can supply a wide range of voltages 
rather than the 3.3 V or 5 V that a Pi offers 


SerialFlashLights.ino 
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/* 
* Blinks two LEDs when motion detected and 
* sends serial message to serial_flash_pi_side.py 


a 
//variables 
int led1 = 5; 
int led2 = 6; 


int motion = 3; 
int wait = 500; //5ØØms = 1/2s 


void setup() { 
// put your setup code here, to run once: 
pinMode(led1, OUTPUT); 
pinMode(led2, OUTPUT); 
pinMode (motion, INPUT); 
Serial.begin(9600) ; 

} 


void loop() { 

// put your main code here, to run repeatedly: 

if (digitalRead(motion) == HIGH) { 
Serial.println("Motion detected!"); 
digitalWrite(led1,HIGH) ; 
digitalWrite(led2,HIGH) ; 
delay(wait); 
digitalWrite(led1,LOw) ; 
digitalWrite(led2,LOW); 
delay(wait); 
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upload the code to Arduino first, then run the program serial flash lights pi side py 
in Thonny. Now when you wave your hand, the lights + i; TIRE 


will flash and a message will appear in the Thonny 
Shell that reads ‘Arduino says: Motion detected’. 


Python | magpi.cc/arduinoandpi 


With a bit of practice, youll 
be capable of developing 
some great projects 


LOOKING AT SERIAL 
First we import the Python serial library with import 
serial. We then need to define the serial connection Next, we read the serial link with the line 
with the Arduino: serialMsg.readline(). However, the serial 
connection will change the encoding of the Arduino’s 
message into something unusable. We need to encode 
the message and strip the extra characters added 
if we’re to use the Arduino’s readings to trigger an 
Note that you could use any name rather than action in our Python script. That’s what the message 
serialMsg. The first argument is the port that the variable does in the SerialFlashLights.ino code. 
Arduino uses, the second is the baud rate of the serial You can replace the mundane print line with almost 
connection, and it’s best to specify a timeout to anything you can think of to make any sensor on the 
prevent overloading. Arduino trigger any kind of event. If your Arduino uses 


ATMEGA328P 
MICROCONTROLLER 

The ATmega328P CPU has very 
little overhead, so it can take 


“ sca (PWM~) 


millisecond-accurate readings. 


OG 8 N O There's not much that can go 
d cause an Arduino to 

B a vant ON wrong an 

TX stall or hang (and if it does, it 
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automatically reboots and runs 
the program). 


Ok 
EEE mem oN MICROCONTROLLER PINS 
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Because the Arduino has 
lower software overheads, 
it's a useful add-on tool for 
sending precise readings to 
the Raspberry Pi. 
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NM MW Serial connections are used to 
Ax < send and read messages to and 
from each device. The messages 
are sent via the USB cable that 
connects the two devices. 
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serial_respond_pi_side.py 
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many sensors, use a different serial message for each 


so that the Python script can tell which action to take. 


PI TO ARDUINO 

Having the Arduino react to inputs from the 
Raspberry Pi is slightly less complicated. In 
SerialLightsRespond.ino we’ve defined our own 
function, flash(). In the void loop() section, 
the flash function’s variable repetitions will be 
replaced by the number received (and converted) 
from the Pi, meaning the lights will flash according 
to the number output by the Pi. 


In serial_respond_pi_side.py we use serialMsg. 


write(b'7' ) to tell the Arduino to flash the LED 
lights seven times. The b is required to properly 


The Raspberry Pi packs far more 
processing power than the 
Arduino Uno. This enables the 
Raspberry Pi to run a full Linux 
desktop interface, and manage 
the higher-level functions. 


The Raspberry Pi can 
communicate with the 
Arduino using serial 
communication. Open a port 
between the Arduino and 
the Pi in code (libraries are 
available for Python and C). 


The Raspberry Pi's HDMI and DSI video 
output ports enable it to run a visual 
interface. They can therefore be used to 
turn the Pi into a controller for the Arduino. 
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encode the message for the Arduino to interpret, 
whether you send text or numerals, they must be 
placed within quotes. 
Unfortunately, whether you send letters or 
numbers, they all arrive as characters - even 
serialMsg.write(b'1') will be received as the text ( 
character 1 rather than a number. 
If you’re sending letters to the Arduino, that’s not 
a problem. However, if you do want to send numbers 
— perhaps to tell the Arduino to flash its LED a 
certain number of times — you need to convert the 
numerical character into a numerical number using 
- @, as in our SerialLightsRespond.ino code. 
When you wave your hand in front of the PIR 
motion sensor, the LED lights will flash seven times. 
Adjust the 7 to any number you want in the Python 
code, and the LED lights will respond accordingly. O 


READY TO GO 
You’ve linked an Arduino to a Raspberry Pi and 
discovered how to control its input/output pins, how 
to read information from the Arduino, and how to 
send messages from the Raspberry Pi to the Arduino. 
With a bit of practice, you’ll be capable of developing 
some great projects. 


Raspberry Pi 3 Model 
CE) Raspberry Pi 


in the UK 


Made 


FCC ID: 2ABCB-RP132 
IC: 20953-RP 132 


Bead ARH AHE DBE 


Cteeeceeceeeererts 
= ose, 


eh 


cia 
LY 


September 2017 MagPi | 67 


68 


ARCADE CABINET 


Galaga. That 1981 arcade game of champions. While you can play 


Galaga in your browser (freegalaga.com), nothing beats the look of 
a light-up arcade cabinet, complete with sticks and giant buttons. In 
fact, Hamburg’s Alex Weber went even further, rescuing an old CRT 


television from a skip to connect to a Pi running 
MAME through RetroPie (retropie.org.uk). 
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} 
} 
} 


An entire city, built from Lego and controlled by 
Arduinos, Raspberry Pis, and bundles of sensors. 

All the parts interact with each other, with myriad 
sensors placed around the blocky cityscape to track 
events within the city and in the real world. The whole 
connected city is powered by a Raspberry Pi running the 
Node-RED Internet of Things manager (nodered.org). 
internetoflego.com 


For his HAMMOND” smart home system, Paul Sieradzki 
used an Arduino Mega to manage everything from 
motors that roll blinds, temperature sensors and PIR 
motion sensors, to relays to control power, IR blasters, 
and RFID readers. There’s a Pi on top to gather weather 
information, add web access, and manage Alexa-based 
voice recognition. A second Pi serves video and music. 
magpi.cc/2vb6NPe 
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Tijuana Rick (aka Ricardo Cortez) used an Arduino Mega to 
transform a 1969 Wurlitzer 3100 jukebox into a digital retro music 
box. He had to go the digital route because, while the jukebox still 
worked, the previous owner kept all the vinyl records. The Arduino 
monitors the jukebox buttons, sending a serial output to the Pi, 
which handles the music playback. 


As part of a HackPrinceton hackathon, Bonnie Eisenman 

created stairs that play a tune. Each step is fitted witha 

light on one side and a light sensor on the other, when a 

foot breaks the beam, an Arduino passes the number of please 5 Sen TES meg 
the step to a Raspberry Pi, triggering a specific note to be “LOLS LE ae TTT eee ~ 
played through a set of speakers. 

magpi.cc/2vbAEST 


FlipFrame solves the problem of 
showing a slideshow of mixed- 
orientation images. Obviously, 
black bars are insufferable, so Tim 
Giles uses a Raspberry Pi to analyse 
his slideshows. If the resolution 
indicates a landscape image, the Pi 
tells a motor-governing Arduino to 
turn the FlipFrame’s 27-inch screen 
from landscape to portrait mode. 

It is a sight to behold. 
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TINY 4WD ROBOT KIT 


Maker 
says 
Tiny AWD 
is a small 
but powerful | 
robot that 
you build 


yourself 
Coretec 


TINY 4WD 
ROBOT KIT 


Rob Zwetsloot looks at a tiny robot with a lot of power, 
in a kit based on a robot you might remember from the magazine 


to issue 51 of the magazine, it using a Raspberry Pi 3 and it website: magpi.cc/2pXHCu8. 


you'll remember a robot worked well. Online instructions aren’t ideal 
on the cover that you could make . — it would be nice to have printed 
Easy build 


yourself. Its designer, Brian instructions in the box - but it’s 


@ f you cast your mind back the chassis. However, we tested online, linked from the Pimoroni 


GOPIGO 3 Corteil, has taken the lessons from The build is fairly quick. There enough to get you started. 

ATES making that robot to build an all- are only three parts to the We managed to get the robot 

expensive kit, new improved version, which you chassis, and one of these isn’t up and running in just under two 

ees can buy directly from his Coretec 

sensors for EG and The kit is optimised for a Pi 

some proper from pimoroni.com. : , ; 

Fess The Tiny 4WD is the end result Zero, with specific mounting 

newbies as well. of this learning process, and is s E 
available as a kit that you build points on the chassis 

one yourself. All you need to supply 

ET is a Raspberry Pi and a way to necessary in its basic state. The episodes of Brooklyn Nine-Nine, 
power it (a mobile USB battery box recommends using the build so we’d estimate 30-40 minutes’ 

£95 / $99 charger will do the trick). The in The MagPi as your instructions, build time, but it may take longer 
kit is optimised for a Pi Zero, but they don’t quite fit this kit. depending on your skills with 

with specific mounting points on Luckily, there’s a great guide a soldering iron. You'll need to 
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solder a 40-pin and a 20-pin 
header to the Explorer pHAT 
supplied with the kit, as well as 
soldering a GPIO header to the Pi 
Zero. The rest of the setup is easy: 
install the software on the Pi Zero 
(running Raspbian) and you’ re 
ready to play! 


Flexible control 

From here you can use the test 
scripts to control the robot 

using a USB controller, or start 
making it more autonomous. The 
Pimoroni library for the Explorer 
pHAT is easy to understand - 

so, with the docs open and the 
examples to hand, you can easily 
start creating your own programs. 

Each side of the Tiny 4WD is 
powered by one of the motor 
outputs on the pHAT. This 
means that, for example, both 
left wheels will always run at 
the same speed and direction as 
each other. This makes it easy to 
turn on the spot, and gives it full 
power when it’s moving forwards 
and backwards. 

The Tiny 4WD is easy to 
customise. There are extra inputs 
and outputs on the board, so 
you can start adding additional 
sensors. There’s a camera mount 
that could be used to attach an 
ultrasonic sensor, or a Raspberry Pi 
Camera Module - like the robots in 
the Formula Pi racing series. 


Power choices 

Choosing a power supply can be 
tricky. The idea is to house your 
power source between the layers 
of the chassis. However, the 
narrow gap, partly blocked by the 
wires to the motors, limits the 
size of any power supply. You'll 
also need to think about power 
capacity — the motors will be 
powered from the Pi’s GPIO pins, 
so your Pi will need more power 
than you might expect. 
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Thumbs up 

We do like this robot overall. The 
build quality is great, with a sturdy 
chassis made from thick acrylic, 
decent micro motors supplied with 
the kit, and the inclusion of a great 
motor controller in the Explorer 
pHAT. The soldering requirements 
make it unsuitable for an absolute 
beginner, but it’d be great as a step 
up for novices. It could even be 
used as a base by more advanced 
robotics users, as you can easily 
swap out the HAT and use a bigger 
Pi to add more functionality. 


EXPLORER PHAT 


THE EXPLORER PHAT IS THE 
PERFECT PROTOTYPING SIDE- 
KICK FOR YOUR RASPBERRY PI! 


om |) 


PIM137 


Unfortunately, supplies are 
limited for this kit, but more 
units are being made all the time. 
If you want one, you may just 
have to be patient. We think it’s 
worth the wait, though. 


last word 


A great little robot kit which could do with some 
better build instructions. Once it's built, however, 


you have a lot of options and plenty of ways to 
make it your own. 
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RASPIO INSPIRING 


From £10/S$13 


Maker 
says 
Connect 
RGB LED 
shapes. 
Sculpt your 


lights 
RasPiO 


RASPIO INSPIRING 


Create impressive illuminations with this dazzling range of light kits 


MOTE 

Instead of 
daisy-chaining, 
each super- 
bright LED strip 
(no shapes) 

is connected 
separately toa 
PHAT or USB- 
connected host. 


From £16/$21 
magpi.cc/2g9iyLs 
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he main selling point of 

RasPiO InsPiRing is the 

ability to daisy-chain a 
variety of LED strips and shapes 
together to create 2D and even 
3D displays. Now headed for 
general sale following a successful 
Kickstarter, the range comprises 
four kits: a strip of eight LEDs 
(£10/£13), a circle or triangle 
of 24 LEDs (£20), an NTP Clock 
kit including Pi Zero (£30), and 
a pyramid kit featuring three 
24-LED triangles (£50). 

Although the super-bright 

APA102c LEDs can be controlled by 
other devices — including Arduino, 
ATtiny, and ESP8266 - each kit 
comes with a pHAT-sized driver 
board for the Pi, communicating 
via SPI. Assembly takes around 20 
minutes and involves soldering on 
a 40-pin header, two small female 
headers, and a socket for a buffer 
chip. The chip translates the Pi’s 
voltage to 5 V logic to drive the 
LEDs. The power supplied by the Pi 
alone should be enough for most 
projects, but there’s the option 
of boosting it with an external 5 V 
power supply if needed. Jumper 
wires are supplied for connecting 


the light strips and shapes to the 
Pi, along with a couple of optional 
10 KQ resistors (not needed in most 
cases). There’s also the option of 
a header for analogue inputs, so 
you could control your lights with 
potentiometers, for instance. 
Male and female four-pin 
connectors are supplied for each 
LED strip and shape, enabling you 
to daisy-chain units together. 
Three sets of input/output holes 
are provided at each end, so you 
can solder your connectors at 
various angles: 180°, 90°, or 45°. 
This offers more flexibility when 
connecting units to create custom 
light displays, although you can 
always just wire directly to the 
holes if you prefer. 
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Indeed, that’s what yov’ ll 
be doing for the pyramid kit. 
After assembling the 3D shape 
from three triangles, held 
together using pieces of sticky 
tape, you’ll need to solder bare 
wires between the input/output 
holes at each vertex, which is 
fairly fiddly. 

Once the hardware is assembled, 
the software is installed on 
the Pi with a single command 
and includes a range of Python 
examples which can easily be 
adapted for your own purposes. 


{ast word 


This range of LED lighting 
kits offers flexible daisy- 
chain connectivity that 
enables makers to ‘sculpt’ 
custom arrangements of 
shapes. The end results are 


impressive: the super-bright 
LEDs creating some dazzling 
displays. The pyramid is a 
particularly fun (if fiddly) 
project to make, and would 
make a great gift. 
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STRATO PI CAN 


Makes 
Raspberry 
Pi more 


professional 
SferaLabs 


\ 


STRATO PI 


Lucy Hattersley looks at an industrial solution for Raspberry Pi 


PICAN 2 
This PiCAN2 
board provides 
CAN bus 
capability for 
the Raspberry 
Pi. It uses the 
Microchip 
MCP2515 CAN 
controller with 
a MCP2551 CAN 
transceiver. 


£33 / $47 
magpi.cc/2ut8ftb 


he Raspberry Pi has 

slowly been making its 

way from the digital 
hobbyist’s garage into professional 
manufacturing environments. 
SferaLabs specialises in smart 
control systems, and its Strato Pi 
boards are a great attempt to add 
commercial-grade hardware to the 
Raspberry Pi board. There’s a range 
of different boards available, and 
we’re looking at the top-of-the 
range CAN board, which has all the 
bells and whistles. 

Most of the Strato Pi boards 
accept 9-28 V, while this board uses 
9-65 V DC power. A high-quality 
power supply ensures reliable 
operation of a Raspberry Pi when 
it’s being used 24/7. The board has 
a step-down converter to provide 
the 3 A continuous output. It also 
features power surge protection (up 
to +500 V, 2 ohms, 1.2/50 us). 

The CAN board also features 
UPS (uninterruptible power 
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supply). In the event of power 
loss, it offers enough time 

to save data and perform a 
clean shutdown. 

Another nifty feature is 
Hardware Watchdog, which 
monitors the software running on 
the Pi. The Strato Pi Can monitors 
a GPIO 5 heartbeat pin (which takes 
less than 60 seconds to change 
state). If it doesn’t see a change, it 
initiates a shutdown procedure and 
raises GPIO 12 to HIGH, which can 
signal to your code that a watchdog 
timeout has occurred, allowing you 
to run a script. 

On the end of the Pi CAN board 
is an 11-position terminal block. 
Power runs into this block, and it 
provides a CAN (Controller Area 
Network) bus and RS-485 ports, 
both of which can be used at the 
same time. The CAN controller is 
used in automotive environments, 
and you can use it to interface with 
a car’s internal network. 


£106 / $138 


Eight of the GPIO pins are used 
to control the real-time clock, 
CAN controller, buzzer, and for 
power management, but you can 
still use the remaining pins for 
pass-through control. You can 
view circuit diagrams and find 
usage instructions in the user 
guide (magpi.cc/2ut7y33) and 
schematics (magpi.cc/2ut6z34). 

A Strato Pi utility is used to 
control the buzzer, watchdog, 
and UPS, installed using: 


sudo wget http://sferalabs. 
cc/files/strato/strato 


{ast word 


Strato Pi CAN is a high-quality 
board, with specific features 


for use in a production 
environment. 
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pimoroni.com/inkyphat 


PAPIRUS 
ZERO 


Available ina 
range of sizes, 
this black- 
and-white elnk 
display has a far 
faster refresh 
rate, plus push- 
buttons to 
control what's 
shown on 
screen. 


£27 / $35 
magpi.cc/20u5KTh 
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Maker 
Says 


A low- 
energy, high- 
falutin, red/ 
black/white 
electronic 
paper display 


for your Pi! 
Pimoroni 


INKY PHAI 


Add a little more colour to your e-Ink display, says Phil King 


ith the ability to display text 
and images that remain 
on screen without using 
a power supply, e-Ink displays are 
ideal for saving precious battery 
life in portable projects. They’re 
also much easier to view in bright 
sunlight than conventional screens. 

Until now, Pi e-Ink displays 
have been black and white - but 
the tri-colour Inky pHAT injects a 
bright shade of red into the mix. 
This certainly adds a dash of extra 
interest to images, such as the logo 
shown on the display when you 
unpack your pHAT. 

Unlike the rival PaPiRus Zero, 
the Inky pHAT comes fully 
assembled, with the e-Ink screen 
already mounted and connected to 


- the board via a small ribbon cable. 


This saves fiddling about with a 
thin and fragile screen, although 
you still have to take care not to 
press on it when mounting the 
pHAT on the Pi’s GPIO pins. 


While the Inky pHAT has a 
Zero form factor, it”ll happily 
work with any 40-pin Pi model. 
Communicating via SPI, it only 
uses six GPIO pins (plus 3 V and 
5 V power). If you wanted to 
ocate the screen away from the 
Pi, however, you’d need to use 
something like a Black Hat Hack3r 
magpi.cc/2fqGyoD). 

A single Terminal command 
installs all the software required. 
The Python library comes witha 
few helpful examples, including 
calendar and a weather display. 
There’s a lot of flashing and 
pulsing as the screen refreshes, 
the red parts usually appearing 
last. While the end result looks 
vibrant, the downside is a much 
slower refresh time compared 
with a monochrome e-Ink screen 
— typically around 15 seconds 
vs 1 second or less. The badge 
example takes even longer, but 
demonstrates the ability fora 


w 


partial update, adding text (your 
name) to a background image. 

The slow refresh rate makes the 
Inky pHAT unsuitable for scrolling 
text, but static text can easily be 
displayed in any installed TrueType 
font, using a simple message 
function in Python. Images are a 
bit trickier, as you need to prepare 
them in a special indexed colour 
mode, and they must also exactly 
match the size of the display 
at 212 x 104 pixels. 


last word 


While the slow refresh rate 
makes the Inky pHAT unsuitable 
for some projects, it does look 
far cooler than a standard 


monochrome elnk display. If 
you want a low-power, battery- 
saving screen with a little more 
pizzazz, this is the one to get. 
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Maker 
says 
A high- 
resolution, 
high-speed 
3.5-inch 
TFT display 
for your 


Raspberry Pi 


Pimoroni 


ADAFRUIT 
PITFT PLUS 
3.5-INCH 
This 480x320 
screen also 
plugs into the 
GPIO pins, but 
only uses eight 
of them. It has a 
resistive, rather 
than capacitive, 
touch interface. 


£45 / $45 
magpi.cc/2uf3kxq 
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Poets, 
3.5" (45.x756mm) 

7 + 
liHyperPixel 
EE. rn 
drm 
The high-speed DPI interface allows Rt 
db tant in 

al 
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O just leaves fingerprints 


OY PERPIXEL 


hile most small screens 

connect to the Pi’s HDMI 

socket, the HyperPixel is 
a HAT that plugs onto the GPIO 
pins. It comes pre-assembled, 
so no soldering is required. On 
a Pi Zero, it mounts straight on 
top fora flush fit. For other Pi 
models, an extra female header is 
supplied to raise the HyperPixel 
so it sits on top of the Pi’s USB 
ports. A rubber foot (to stick to 
the top of the Ethernet port) and 
a support bolt are also supplied to 
provide extra stability. 

Before you can use the 
HyperPixel, you”ll need to install 
some software. Fortunately, as with 
most Pimoroni products, you can 
use a one-line installer command 
in the Terminal. To enter the 
command you’ll need to hook the 
Piup to another monitor, or access 
it remotely via SSH. When the 
software has been installed, the Pi 
will only display to the HyperPixel, 
unless you revert the config. txt file. 


Once it’s all up and running, 
you’re sure to be impressed by 
the HyperPixel's performance. 
The 800x480 resolution matches 
the official Pi 7-inch touchscreen, 
and with a pixel density of 270 
ppi, the HyperPixel beats its rival 
3.5-inch screens. The display 
looks seriously sharp with vibrant 
colours (18-bit for 262,144 
shades) and good viewing angles. 
There is some occasional colour 
banding when displaying 
fine gradients, but it’s hardly 
noticeable. With a frame rate 
of 60 fps, videos look superb — 
although we noticed a tiny bit of 
distortion at the right-hand edge 
when streaming YouTube videos 
(but not when playing those 
stored locally). 

That frame rate is down to 
the use of DPI (Display Parallel 
Interface). The downside to this 
is that the 18-bit colour uses 
18 GPIO pins, while the rest are 
needed for functions including 


Vibrant mini screen packs a lot of pixels into a small space - Phil King 


syncing and two-point capacitive 
touch. [PC and SPI are also 
disabled. Naturally, this limits 
the screen’s usefulness for some 
projects. In addition, if you want 
to use PWM for fine control of 
the backlight brightness, you 
won’t be able to output audio via 
the Pi’s 3.5 mm jack. 


{ast word 


While not suitable for 
projects requiring GPIO pins, 
the HyperPixel is ideal for 
use in a mini media centre, 
portable retro games 
console, camcorder (see 
magpi.cc/2tjrgNq), or as a 


touchscreen interface. Since 
the Raspbian desktop is too 
fiddly to control in miniature, 
you'll want to create your own 
custom GUI. Whatever you use 
it for, this is a stunning screen. 
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PI-TOPPULSE 


A new multimedia add-on that brings lights and sound 
to a pi-top or a Raspberry Pi. Rob Zwetsloot takes a look 


UNICORN 
HAT HD 
With its 
programmable 
16x16 RGB LED 
display, this 

is a great HAT 
that is easy to 
code and fun to 
use in a range 
of projects. 


£32 / $41 
magpi.cc/UniHATHD 
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e love the pi-top range 

of computers. They 

provide true PC or laptop 
conversion kits for the Raspberry 
Pi, customisable with plug-in 
modules and aimed at educational 
users. Usually these add-ons 
are designed to enhance the 
experience of using the pi-top, 
but that’s all changing with their 
latest and most ambitious add-on, 
the pi-topPULSE. 

It may be ambitious, but it is 
also very cool. From the top, it’s 
an unassuming white plastic 
square. It includes a 7x7 LED 
display under the plastic, plus a 
microphone and speaker. The PCB 
is visible on the underside, but it 
is lovely and well designed. 

On its own, it can be plugged 
into a pi-top using the special 
magnetic rails inside the slide-out 


compartment, but it can also be 
used as a HAT on the Raspberry Pi. 
You'll need to plug in a header to 
the underside of the PULSE before 
popping it on the Pi, but it works 
with Raspbian after installing a 
single piece of software. 

It’s avery tight fit on the 
Pi. The case barely misses the 
Ethernet port, and the connectors 
for the pi-top hang over the 
board, increasing the footprint 
of the Pi. As an educational tool 
it is excellent, with a very robust 
Python library for creating light 
displays and games. 

The microphone and speaker 
give you access to other functions. 
The PULSE acts as a fully 
integrated speaker for Sonic Pi, 
and is even optimised for use with 
Amazon Alexa on the Raspberry 
Pi. There’s a great demo on the 


product page that shows how it 
can be used with Alexa. 

It is a little tricky to get your 
head around the programming, 
but there are plenty of examples 
that helped us figure out how to 
use everything. 

All in all, it’s one of the most 
fun HATs we’ve seen in a while, 
allowing users to explore many 
amazing project ideas. 


last word 


An amazing idea with great 
execution - we just wish it 
was slightly easier to program. 


With a bit of practice you can 
create some astounding things 
with the PULSE. 
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Providing 
you with 
hours of 


entertainment 


building 


projects that 
can read and 


write from 
13.5 MHz 
contactless 
RFID 


smart cards 
Monk Makes 


CLEVER CARD KIT 
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CLEVER CARD KIT 


Rob Zwetsloot adds RFID tags to his projects with a set of rewritable 
contactless cards and this special add-on 


RAINBOW 
HAT 
STARTER 
KIT 


This kit doesn't 
use RFID, but 

it does allow 
you to interact 
with the 
environment, 
time, and the 
internet to 
learn about 
code and then 
make your own 
amazing things 


© 
£80/$103 
magpi.cc/2vXINwQ 


n this issue of The MagPi 
we have a tutorial on 
creating an automation 
system with Bluetooth tags, using 
the Pi Zero W’s built-in Bluetooth 
connection to detect Bluetooth 
signals (page 22). This project 

is based on the concept of key 
cards and other contactless RFID 


This project is based on the 
concept of key cards and other 
contactless RFID technology 


technology. Now, thanks to this 
kit, you can easily create your own 
Pi-based RFID projects. 

This simple, cheap kit allows 
you to add an RFID reader toa 
Raspberry Pi. It comes with six 
RFID-compatible cards and an 
RFID key fob. Being a Monk Makes 
kit, it also comes with some other 
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goodies to help you play with 
your new project, including a 
push button and an RGB LED. The 
lovely printed booklet that comes 
with the kit includes instructions 
for projects that use the extra 
goodies, and takes you through 
the easy Python code needed to 
set up the reader. 


The book starts with some basic 
projects and finishes off witha 
special ‘Monopoly’ project, which 
allows you to assign money to 
each RFID card and play the game 
without using stacks of cash. 

It’s a wonderful little kit, and 
it’s so easy to use. The projects 
in the book require absolutely 


zero soldering - although if you 
want to make something a little 
more complex, you can always get 
your soldering iron out. It doesn’t 
require much extra software 
installation either, so we had the 
reader up and running in no time. 
Finally, the inclusion of the cards 
and key fob are very welcome - 
we already have some ideas for 
projects using these in the future. 

And did we mention that it’s 
only £15? That’s a bargain any day 
of the week. 


{ast word 


Areally fun kit idea from Monk 
Makes that does a great job of 
teaching you how to use RFID 


readers, and inspires you to go 
out and do much more with 
the technology. 
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Raspberry Pi for professional applications 


kd 


SU QUO 


Strato Pi enhances the Raspberry Pi and the Compute 
Module with hardware features that make them 
suitable for use in professional applications where 
reliability and service continuity are key requirements. 


CE/ROHS 
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WIDE RANGE 
POWER SUPPLY 


Oe 
GONE) 
lono Pi is a versatile I/O module that 
combines digital and analog standard 


interfaces with the powerful 
computing core of the Raspberry Pi. 
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RASPBERRY PI 
BESTSELLERS 


A camera is just a piece of hardware. 
Vision lies in software - and understanding. 


LEARNING OPENCV 3 


Authors: Gary Bradski 

& Adrian Kaehler 
Publisher: O'Reilly 
Price: £59.99 
ISBN: 978-1491937990 
magpi.cc/2hGVLM4 


Targeting the C++ API, Kaehler 
and Bradski's near 1,000-page 
work covers every aspect of 
real-time image processing 
library OpenCV, as well as some 
useful insights into computer 
vision in theory and practice. 


VISION AND BRAIN: 
HOW WE PERCEIVE © 
THE WORLD 


Author: Dr James V Stone 
Publisher: MIT Press 
Price: £29.95 

ISBN: 978-0262517737 
magpi.cc/2ulRAqA 


A computational theory of 
vision. Dr Stone's enjoyable 
and accessible look at the how 
and why of animal and human 
vision will give you a fresh 
perspective on the subject. 


RASPBERRY PI 
IMAGE PROCESSING — 
PROGRAMMING 


Author: Ashwin Pajankar 
Publisher: Apress 

Price: £14.99 

ISBN: 978-1484227305 
magpi.cc/2umpujg 


Putting it all together on 

the Pi: a compact but useful 
introduction to Python-based 
image capture and processing 
on the Pi, with pillow, scipy, 
and matplotlib. 
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NUMSENSE! 


Authors: Annalyn Ng 
& Kenneth Soo 
Publisher: Annalyn Ng & 
Kenneth Soo 
Price: £23.99 
ISBN: 978-9811110689 
magpi.cc/2umfEOg 


Data science is 
everywhere (as is hype about 

data science), as intelligent analysis 
of petabytes of new data becomes 
essential to governments, business, 
charities, and anyone looking to 
make intelligent predictions. The 
field requires strong mathematical 
skills, but what about people who 
need to make decisions about 

data, but who are not statisticians 
and programmers? 

Ng and Soo’s guide to Data 
Science for the Layman: No Math 
Added is a clear explanation of 
ten data analysis algorithms for 
supervised and unsupervised 
learning - plus one reinforced 


PY THON IN 
A NUTSHELL 


Authors: Anna Ravenscroft, 
Alex Martelli, 
& Steve Holden 
Publisher: O'Reilly 
Price: £55.99 
ISBN: 978-1449392925 
magpi.cc/2ulYkoE 


Alex Marte 
Anna Ravenscroft & Steve Holden 


A long time in the 
making (the second edition 
was released more than a decade 
ago), the cover refers to this book as 
‘a desktop quick reference’ - and it 
is the place to look up queries about 
Python, the standard library, and 
many parts of the Python ecosystem 
- but the size of this edition (more 
than 700 pages) is a heavyweight 
indicator of Python’s growth. 
O’Reilly’s venerable nutshell 
series offers a comprehensive 
treatment of every topic — in this 
case Python for programmers 
coming from other languages, or 


Python 


m a Nutshell 


learning example - preceded by a 
basic look at data selection. Each 
algorithm is illustrated with a 
well-chosen data example, which 
is examined with illustrative 
graphs, clear text, and no 

mathematics, rounded off with 

a look at the limitations of the 

algorithm chosen. 

From soccer penalties and obese 
giraffes, to PageRank and social 
networks applied to geopolitics 
and weapons sales, Numsense!’s 
examples illustrate and illuminate, 
but the real clarity comes from the 
direct writing style, and the authors’ 
understanding of the subject matter. 
This book is not just for the non- 
technical reader - any programmer 
looking to understand data science 
and machine learning will quickly 
gain an appreciation of algorithms 
that other works introduce in a far 
less digestible form. 


Score 


those with a little Python who need 
to know more. Coverage is split 
between the basics (with plenty of 
detail on alternatives to standard 
CPython); core Python and 
the standard library; and 
a mixture of standard and 
extension libraries over topics 
such as databases, numeric 
processing, and dealing with 
testing and debugging. 
Treatment is always detailed 
enough to get the job done. 
Network and web protocols 
make up the penultimate 
section; and the book is rounded 
off with extending, embedding, 
packaging, and the issues arising 
between versions 2 and 3 of 
Python. This may not be the book 
you’ll use to learn the language, 
but put it on your shelf and you’ ll 
often reach for it as a reference 
text throughout the time that you 
use Python. 


Score 
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ELECTRONICS 
COOKBOOK 


Sey 
Author: Simon Monk 3 
Publisher: O'Reilly 
Price: £39.99 
ISBN: 978-1491953402 
magpi.cc/2umkUBo 


In the 1970s 
and 1980s, 
newsagents’ shelves 

were stacked with titles like 
Everyday Electronics and Practical 
Wireless, and amateur electronic 
hardware knowledge would 

be applied everywhere from 

home hi-fi to DIY guitar pedals. 

A combination of pervasive 
computing and ready-made 
hardware devices costing pennies 
means modern Pi users are far 
more likely to be familiar with 
software than hardware. How 

to catch up on a mix of theory, 
component knowledge, and dozens 
of useful circuits? 


KOTLIN 
IN ACTION 


Authors: Dmitry Jemerov 
& Svetlana Isakova 
Publisher: Manning 
Price: From £20 (Amazon 
resellers only in the UK) 
ISBN: 978-1617293290 
magpi.cc/2vgdw9D 


Simon Monk 


Kotlin is a JVM language 
from JetBrains, the people behind 
the IntelliJ IDEA Java IDE. Not 
the first language to attempt to 
fix the problems of Java (hello 
Scala!), but uptake has been swift, 
and we’ve heard praise for the 
language even from some notable 
Pythonistas. Kotlin is touted as 
a good replacement for Java in 
Android development — something 
of additional interest here, with 
Android Things running on the Pi3. 
This book is aimed squarely at 
Java developers: you don’t need 
to be aJava expert to benefit from 
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Enter the ever-useful Simon 
Monk, with a cookbook that has the 
potential to become another O’Reilly 
classic. True, you’ll need to make 
reference to the Errata page on 
the O’Reilly website, in particular 
for the first half dozen chapters; 
but this is a great collection of 
practical electronics know-how, 
nominally built around the needs 
of small board users, but essential 
for any learner. 
The recipe format is stretched 
a little in the early chapters, to 
introduce theory and the basics of 
discrete components, but soon the 
recipes become mini-projects in 
themselves, and potential building 
blocks for all manner of Pi-based 
constructions. For old hands, 
it’s nice to have all these circuits 
collected together - and your old 
reference books won’t have this 
one’s Pi and Python recipes. 


Score 


this very effective guide, but 
non-Java users should wait for a 
different Kotlin book. Jemerov and 
Isakova are Kotlin insiders. They 
make a persuasive case 
in the ‘What and Why’ 
chapter, before moving 
on to the basics of ‘how’ 
- emphasising the lack of 
boilerplate in examples 
such as declaring classes, 
and showing off the 
language’s type inference. 
Classes are expanded 
ina chapter which highlights 
the differences from Java in 
interfaces. Improved function calls, 
adding methods to Java classes or 
interfaces, lambdas, and Kotlin’s 
extensive type system round off the 
first half”s language introduction. 
The second half gets you building 
your own APIs, using higher 
order functions, and using deeper 
features such as DSLs. 


Score 


BOOKS 


ESSENTIAL READING: 
BEYOND FRAMEWORKS 


Frameworks can hinder understanding. Get to 
know the nuts and bolts of web development. 


Build your 
own AngularJS 


Author: Tero Parviainen 
Publisher: Teropa 
Price: £15.00 
magpi.cc/2vKuoWA 


BUILD YOUR OWN 


ANGULAR 


A deep dive into the workings of a web 
framework, guiding you to better skills, 
and confidence in your knowledge. 


Modern 
JavaScript 


Author: Various 

Publisher: Sitepoint 

Price: £5 or Sitepoint subscription 
magpi.cc/2vgEgH1 


MODERN 
JAVASCRIPT 


Having trouble keeping up? Sitepoint's 
latest anthology is a quick introduction 
to the most important parts of the 

JS ecosystem. 


Go in Practice 


Authors: Matt Butcher & Matt Farina 
Publisher: Manning 

Price: £27.99 

ISBN: 978-1633430075 
magpi.cc/2vjoJBA 


a 
b0 4 


en 
IN PRACTICE" or å 


Pattern-focused guide to the highly 
concurrent language that could solve 
your web app problems. 


Refactoring 
JavaScript 


Author: Evan Burchard 
Publisher: O'Reilly 
Price: £39.99 

ISBN: 978-1491964927 
magpi.cc/2vC59Gi 


Refactoring and testing will turn 
bad code to good. Well-written and 
enjoyable read - strongly recommended. 


Inclusive 
Design Patterns 


Author: Heydon Pickering 
Publisher: Smashing Magazine 
Price: £27.00 

ISBN: 978-3945749432 
magpi.cc/2viJIYp 


INCLUSIVE 


DESIGN PATTERNS 


Hæ ja 
LZIN 
Fen 
VIG 
Best practices for pages accessible to all nn 


users, reconceiving web design as code- 
not pixel-based. Essential reading. 
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AN INTERVIEW øl 


Project Things is a new framework involving Mozilla’s 
Web of Things, and is now available on the Raspberry Pi. 
What exactly does this mean? 


he maker community was 

abuzz with excitement 

when Mozilla announced 
Project Things last month, so we 
sat down with Benjamin Francis 
from the development team to 
talk about exactly what it means. 
Here’s what he told us. 


Can you explain what 

Project Things is? 

Project Things is an experimental 
framework of software and services 
to help developers connect ‘things’ 
(physical objects in the real world) 
to the World Wide Web in a safe, 
secure and interoperable way. The 
project includes developing a ‘Web 


Things Cloud 


Things Gateway 


Things Framework 
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of Things” gateway, which helps 
bridge existing IoT devices to the 
web; a collection of cloud services 
to help manage a large number of 
IoT devices over a wide geographic 
area; and a framework of reusable 
software components to help 
create IoT devices which directly 
connect to the Web of Things. 

The first piece of the framework 
we’ ve released is an early prototype 
of an open-source Web of Things 
gateway. Anyone can download 
the software image from Mozilla’s 
website and build their own Web of 


Things gateway using a Raspberry Pi. 


The gateway enables users to choose 
a unique web address for their 

home without any complex DNS 

or router configuration, by using a 
secure tunnelling service provided 
by Mozilla. The gateway can then be 
used to monitor and control existing 
smart home devices like ZigBee and 
Z-Wave smart plugs and sensors, 
and access them remotely via a 
unified web interface. 

Our initial demo showed how 
you can turn smart plugs on and 
off from a web app. We’re now 
working with the community 
to add support for new types 
of devices and protocols via an 
adapter add-on system, and 
developing new components like 
a rules engine which can be used 
to define automated rules for how 
individual ‘things’ interact with 
each other (e.g. having a light turn 
on when a sensor detects motion). 


Welcome 


Choose a secure web address 
for your gateway: 


subdomain MulerlEgiedelg: 


Next 


Project Things is easy to set up 


Why the Raspberry Pi? 

The Raspberry Pi 3 is affordable, 
easy to get hold of, runs Linux, 
and has wireless LAN and 
Bluetooth built in. This makes it 
an ideal hardware platform for 
the initial use cases — and the 
initial audience of DIY hackers 
and makers we’re targeting with 
Project Things. We plan to support 
other hardware platforms in the 
future too, but the Pi was a great 
starting point for us. 


Do you find it difficult to convey 
exactly what the IoT is to people? 
People have diverse ideas about 
what the Internet of Things 

is, and there’s really no single 
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MOZILLA, IOT, AND THE RASPBERRY PI: AN INTERVIEW Community 


oz:lla 


lol 


accepted definition. It can 
range from sophisticated cloud- 
connected smart devices with 
artificial intelligence, to tiny 
RFID tags in smart packaging 
which give physical products an 
identity on the internet, used 
for inventory tracking or smart 
consumer experiences. 

What makes IoT particularly 
confusing for end users is that 
because the technology is still 


the World Wide Web and apply 
them to the Internet of Things. 
It’s about creating a decentralised 
Internet of Things by making 
Things linkable and discoverable 
on the web, and defining standard 
data models and APIs (application 
programming interfaces) to 
make them interoperable. 

To put it simply, it’s about 
giving Things URLs on the web. 

We're working with the W3C 
(World Wide Web Consortium) 
to help define standards for 
a decentralised Internet of 
Things, including a standard 
Web Thing description format 
to describe Things, and APIs to 
communicate with them. Project 
Things is Mozilla’s open-source 
implementation of those 


The gateway enables users 
to choose a unique web 
address for their home 


in its infancy, there are no 
universally agreed standards for 
how connected devices should 
communicate. This means that 
there are lots of proprietary 
products and platforms available 
which can’t talk to each other, 
so it’s easy to get locked into 
a particular brand or cloud service. 
At Mozilla we want to help 
educate users about the security, 
privacy, and interoperability issues 
around new IoT devices, while 
helping to define new standards 
for a decentralised Internet of 
Things which is safe and secure. 


What is the Web of Things? 


The Web of Things is an effort 
to take the lessons learned from 
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proposed standards, but like all 

web standards, anyone is free 

to implement the specifications 
themselves in the programming 
language of their choice. 


How can people get started? 

Go to iot.mozilla.org to download 
our Things Gateway software 
image and follow the instructions 
to flash the image onto an SD 
card. You can then plug the SD 
card into your Raspberry Pi, plug 
in USB dongles for any additional 
wireless protocols you want to 
support, then access the gateway 
via your web browser to set up a 
secure web address for your home. 
You can pair devices like ZigBee 
and Z-Wave smart plugs with the 


Things Gateway 


Front End 


(HTML, CSS & JavaScript) 


Web Thing API 
(HTTPS+WSS) 


Back End 
(Nodejs) 


ZigBee Z-Wave 
Adapter Adapter 


Serial 


OS 


gateway and control them from 
your browser using the built-in 
web app. 

Project Things is an 
open-source project and we 
really encourage community 
contributions. There are lots 
of ways you can contribute, 
such as building your own IoT 
device which uses the proposed 
standard Web Thing API 
(magpi.cc/2vMuYBo), creating 
an adapter to bridge an existing 
IoT protocol or device to the web, 
or hacking Project Things itself 
to help us develop Mozilla’s 
Web of Things implementation 
(github.com/mozilla-iot). 

We”re looking forward to seeing 
what the hacker and maker 
community can build with this 
software as it develops, and 
we’d love to hear about your 
DIY IoT projects! 


-: Mozilla IoT 
OG for Raspberry Pi .. 
e 
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FEATURE 


THE MONTH IN 


Everything else that happened this month in the world of Raspberry Pi 


For some reason, everyone’s been using their AIY Projects Voice Kits 


in phones and intercoms this month... 


arlier in this very issue, you’ll have seen an 
amazing project that uses the AIY kit from 
issue 57 to hack an old-school intercom and 
turn it into a digital voice assistant. It’s a wonderful 
project, and we always love seeing what Martin Mander 
is going to upcycle next. 

Strangely, everyone else has been having the same 
idea! We saw loads of toy phones, intercoms, and other 
voice-powered products upgraded using AIY kits. Here 
are some of our favourites. 


Kids’ smartphone 


Martin Mander's intercom project is retro and lovely 
This one is a little mean but honestly, we laughed. This 
Fisher-Price phone is a true classic and we love the idea 
Another intercom? of giving it a hefty upgrade with AIY, complete with a 
massive glowing button in the centre. Would it be creepy 
if you made it sing while the eyes moved? Very probably. 


Already Martin is inspiring 
other makers. Here’s another 
intercom voice project in 

the works, this time using 
Amazon Alexa. One day we’ll 
have to run a comparison 
between the different voice 
assistant platforms. Perhaps 
we should have a retro intercom 
competition to decide it? 
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Operator! 


More retro upcycling with this old-school phone, 


upgraded to incorporate an AIY kit. Dial zero 

to talk to the assistant and get answers to your 
everyday queries. We have visions of someone 
picking it up and putting it under their chin to ask 
for ounce-to-gram conversions while they mix 


some batter, Nineties style. 


Toucan play at that 


This one is just fun. It’s noise-activated, and the 
assistant voice really doesn’t match its appearance. 
Maybe you could mod it so it has a Gilbert Gottfried 
voice? It also moves about as it speaks, adding to 


the Coolness Factor™. 


ÅKE. Joel Marquez 
hd 


Shhh! Geniuses at work! I've got an 
AWESOME team! 


&y Jacqui Garrad 
iF? i 


using the 


Still waiting for an AIY 
kit? They're coming, 
we promise! The best 
way to find out more 
is to sign up to our 
mailing list - that way 
we can let you know 
as soon as they go on 
sale. You can sign up 
at magpi.cc/Email-me. 


really creative ideas 


DB BAKE Follow 
DXF CARE De G 
FAA 


#raspberryjam 
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NEW 
RASPBIAN 


STRETCH 
OUT NOW! 


We got a massive Raspbian update this 
month - here’s what you need to know 
about the latest Raspbian release 


Raspberry På - TREN (earn, and Make with Rasberry Fi - vonar 


Debian 
releases are 
named after Toy 
Story characters. 
Stretch is an 
octopus toy from 
Toy Story 3, about 
whom you've 
probably forgotten 
after your heart 
shattered at 

the end... 
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t doesn’t seem very long ago that Raspbian 

Jessie came out. The successor to the original 

version of Raspbian, Jessie brought us a lot of 
minor upgrades and visual overhauls that are now a 
normal part of the Raspbian experience. 

New Debian releases happen roughly every two years. 

Jessie came out in September 2015, so it’s now time for 
Raspbian to upgrade to Stretch. The major upgrades this 
time are happening below the surface, so you shouldn’t 
notice many differences when you’re using the desktop. 
What you will find is upgraded software, including 
Chromium, and Bluetooth audio via ALSA, along with... 


SONIC PI 3.0.1 


Sonic Pi 3.0 boasts a lot of new features, including: 


Time State a powerful new time-based 
deterministic shared memory system 


MIDI support for input and output of MIDI 

OSC support for sending and receiving 
OSC messages on the network 

Live Audio for getting multiple streams of audio 
into Sonic Pi 


Multi-channel for outputting multiple streams 
audio out of audio 


Audio Buffers for internal recording of audio, 
enabling the creation of loopers 


| ZD CD 60 ED ED 


SCRATCH 2 SENSE HAT EXTENSION 


Scratch was upgraded in the last Jessie release to 
Scratch 2, and this upgrade gives it the ability to 
interact with the Sense HAT. Hopefully this will 

introduce Scratch users to Astro Pi! 


a - "= 
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KICKSTART THIS! 


Raspberry Pi projects you can crowdfund this month 


BEST OF THE REST 


o—o 


Eee ET CNC WOOD 


=> BURNER 


BOBOP 


BOBOP is billed as ‘the first smart robot for parents’. 
It looks a bit like the Mira bot project, featured earlier 
in this issue, although this one apparently keeps an 
eye on your kids. According to the creators, it was 
prototyped heavily with a Raspberry Pi, which is still 
being used as one of its main computers. You should 
just have enough time to give it a look before it ends. 


Lil 
JEEP ACCELEROMETER 


magpi.cc/2w5LKCU 


gå 


Smarti Pi Flex 


Raspberry Pi Zero camera arm 


AUTOMATIG VIDEO WALL 


SMARTIPI FLEX EE 


This is a neat project. It’s a special case for a Pi Zero 
and the Raspberry Pi Camera Module, with a flexible 
arm that holds the camera in a fixed position. It’s a 
simple but great idea, allowing you to make some really 
cool camera-based projects. The campaign will have 
just finished by the time you read this, but hopefully it 
hit its target and you can pre-order one for yourself! 


raspberrypi.org/magpi September 2017 MagPi | 87 


Educators gather in Cambridge to find out how they can take their Code Clubs further 


Peter 

Onion's demos 
drew crowds of 
people wanting 
to know more! 


raditionally, Code 
Clubs are places for 
educators to teach kids 
about computer science. There 
are thousands of them around 
the world and they’ve helped 
countless students improve 
their computing skills through 
fun activities. 
In Cambridge, in late July, 
a different kind of Code Club 
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meeting took place. Volunteers 
and educators who run Code 
Clubs, along with prospective 
Code Club hosts, visited Code Club 
(and Raspberry Pi!) HQ to attend 
some talks, get to know other 
Code Club volunteers, and find out 
how to improve their Code Clubs. 
"At the event in Cambridge, 
everybody had a chance to get 
hands-on with Code Club projects 


using pi-tops,” said Sarah 
Sheerman-Chase, Participation 
Manager at Code Club. “Peter 
Onion, who is a volunteer at a club 
in Essex, demonstrated physical 
computing with micro:bits. 

There was also plenty of time for 
networking, and the opportunity to 
meet the team, including Mickey 
Day, the Code Club Coordinator for 
the East of England, and myself.” 
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Plenty of demos were on hand 
for volunteers to try out and 
see what students could learn 


While this was a relatively 
small event held in a conference 
room, it was pretty packed and 
full of excited Code Clubbers 
wanting to learn more and share 
their experiences. We saw many 
people getting to grips with some 
of the example projects on the 
pi-tops in the room, while others 
were wowed by Peter Onion’s 
computing demos. 


thought it was a good way of 
engaging them beyond Scratch. 
Now we’ve finished this academic 


year and they’ve all said how much 


they’ve enjoyed it. The volunteers 
are doing fantastic work.” 

We always hear about Code 
Clubs being constantly full, and 
how kids really enjoy them, and 
Anne’s club was no different. 
“We’ve had a very successful 


Everybody had a chance to 
get hands-on with Code Club 
projects using pi-tops 


A sea of volunteers 

We spoke to Anne Worthington, 
who runs a Code Club at 
Cambridge Central Library, which 
has become very popular. 

“Tt was a bit slow to begin 
with,” Anne admitted to us. 
“Then, as soon as people knew 
what it was about, we started 
filling up a waiting list and 
we managed to satisfy those 
requests to get on board.” 

It began with a taster session, 
held in partnership with a sister 
event in Huntingdon. The club 
eventually started in the middle 
of the school term with a focus on 
Scratch and Python. 

“Those who had done Scratch 
could move onto Python,” 
explained Anne. “The volunteers 
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year, with a full complement of 
14 or so children at each session. 
A bit up and down with holidays 
and family life, but it was just 
joyous seeing how much better 
the children got at the activities. 
We have similar Code Club 
activities running in Huntingdon 
and St Neots, and we’re looking 
to expand to libraries out in The 
Fens as well.” 


Choose your 

own adventure 

One of the volunteers for the 
Cambridge Central Library Code 
Club, Krishna Kumar, helped 
develop learning resources for 
the micro:bit, which the club 
plans to use — a hot topic of 
discussion at the event. 


CODE CLUB MEETUP 


He also helps out in the Code 
Club sessions, revealing that 
their club has a far better gender 
ratio than the tech workforce as 
a whole, with girls making up 
between 35 and 40 percent of 
their attendees. 

He feels the courses have a 
great deal of choice in them, 
allowing every participant to 
create projects based on their 
own interests. 

After munching on some pizza, 
it was time to head home, but 
everyone seemed to leave with 
new ideas and inspirations to 
start or improve their Code Clubs. 


START A 
CODE CLUB 
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Category: High-altitude 
balloonist 


Day job: HAB enthusiast/ 
software engineer 


Website: daveakerman.com 
twitter.com/daveake 


Below Dave continues to help 
others while breaking records 
and having a good time 
exploring the atmosphere 


| = COMMUNITY PROFILE 


å DAVE 
| AKERMAN 


High-altitude balloonist and master of 
LoRa, Dave likes to send Pis as high as 
the atmosphere will allow 


he pinned tweet on Dave 
Akerman’s Twitter account 
shows a table displaying 
the various components needed 
for a high-altitude balloon (HAB) 
flight. Batteries, leads, a camera 
and Raspberry Pi, plus an unusually 
themed payload. The caption reads 
"The Queen, The Duke of York, and 
my TARDIS’, and sums up Dave’s 
maker career in a heartbeat. 
Though writing software for 
industrial automation pays the 
bills, the majority of Dave’s time 
is spent in the world of HAB and 
the ever-growing community 
that encompasses it. And, while 
he makes some money sending 
business-themed balloons to near- 
space for the likes of Aardman 
Animations, Confused.com and 


the BBC, Dave is best known in the 
Raspberry Pi community for his 
use of the small computer in every 
payload, and his work as a tutor 
alongside the Foundation’s staff at 
Skycademy events. 

Dave has dedicated many hours 
and many, many more miles to 
assisting with the Foundation’s 
Skycademy programme, helping 
to explore HAB with educators 
from across the UK. Using a 
Raspberry Pi and various other 
pieces of lightweight tech, Dave, 
and Foundation staff member 
James Robinson, explored the 
incorporation of high-altitude 
ballooning into education. Through 
Skycademy, educators were able 
to learn new skills and take them 
to the classroom, setting off their 


Dave doesn't just launch balloons for fun. 
With clients such as the BBC and Heston 
Blumenthal, he’s launched all manner of 
items into space... including a potato! 
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magpi.cc/2vXHvEx 


own balloons with their students, 
and recording the results on 
Raspberry Pis. 

But education isn’t the only 
reason for Dave’s involvement 
in the HAB community. As 
with anyone passionate about a 
specific hobby, Dave strives to 
break records. The most recent 
record-breaking flight took place 
on 13 August 2017, as Dave’s 
Raspberry Pi Zero HAB sent home 
the highest images taken by any 
amateur high-altitude balloon 
aunch. At 43,014 metres, no other 
HAB balloon has provided images 
from such an altitude, and the 
ightweight nature of the Pi Zero 


definitely helped, as Dave went 
on to mention on Twitter a few 
days later. 

Dave first fell in love with high- 
altitude ballooning after coming 
across the hobby as a video shared 


progression. Throw in his coding 
skills from learning to code ona 
Teletype and it’s no wonder he 
was ready and eager to take to the 
skies, so to speak, and capture the 
curvature of the Earth. What was 


As with anyone passionate 
about a specific hobby, Dave 
strives to break records 


on a photographic forum. With a 
lifelong interest in space thanks 
to watching the Moon landings as 
a boy, plus a talent for electronics 


and photography, it seems a natural 


Dave's most recent flight broke a new record. On 13 August 2017, his HAB 
payload was able to send back the highest images taken by any amateur flight 
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so great about using the Raspberry 
Pi was the instant gratification 
gained when receiving images 
in real-time as they were taken 
during the flight. While other 
devices could operate a camera 
and store the photographs for 
later retrieval, Dave was able to 
transmit them back down to Earth 
and check the progress of his 
balloon while attempting to break 
records with a flight. 
High-altitude ballooning isn’t 
the only part of Dave’s life that 
incorporates a Raspberry Pi. 
Having “lost count” of how many 
Pis he has running tasks, Dave 
has also created radio receivers 
for APRS (ham radio data), ADS-B 
(aircraft tracking), and OGN 
(gliders), along with a time-lapse 
camera in his garden, and a few 
more for tinkering purposes. 
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EVENT CALENDAR 


Find out what community-organised, Raspberry Pi- 
themed events are happening near you... 


Want a Raspberry Jam in p3 - Å 
your Bren? Want to start eme? A ya >, o > A 8 4) brits G 
Email Ben Nuttall about it: J K & pe È 
ben@raspberrypi.org A g 8 
pe ~ 
N 
3 ù 
HIGHLIGHTED EVENTS REGULAR EVENTS 
TECHNO JAM JAMMING CORNWALL TECH JAM 
When: Saturday 9 September IN MARLBOROUGH When: Saturday 9 September 
Where: Southport College, When: Saturday 16 & 23 September Where: Cornwall College Camborne, 
Southport, UK Where: Marlborough Library, Redruth, UK 
technojam.uk Marlborough, UK cornwalltechjam.uk 
An event for people who are magpi.cc/2xa25yq For all ages and abilities: ask 
interested in all forms of Drop in to Marlborough Library on questions and learn about 
technology to come together Saturday morning to see Raspberry programming in Scratch, Python, 
and share their knowledge. Pis being used in a variety of ways. Minecraft, and much more. 
GUILDFORD RASPBERRY HULL RASPBERRY JAM 
RASPBERRY JAM JAM JOBURG When: Saturday 9 September 
When: Saturday 16 September When: Saturday 16 September Where: Hull Central Library, 
Where: Guildford Library, Where: Entelect, Johannesburg, ull, UK 
Guildford, UK South Africa magpi.cc/2wgiUv8 
magpi.cc/2xawKf1 magpi.cc/2wgrJVW There”ll be chances to get hands- 


Learn about Raspberry Pis, get 
help from others, show off 
your projects, and meet other 
Raspberry Pi fans. 


You'll get the opportunity to 
demonstrate your Pi project 
and discuss it with other like- 
minded Pi enthusiasts. 


on with digital making activities 
through workshops, and a 
hackspace area to share projects and 
give lightning talks. 
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MANCHESTER 
RASPBERRY JAM 
GUILDFORD 
RASPBERRY JAM 


5) CORNWALL TECH JAM 


YY 


MANCHESTER 
RASPBERRY JAM 

When: Saturday 9 September 
Where: The Shed, Manchester, UK 
magpi.cc/2wgeAMp 

A very long-running Jam that 
celebrated its fifth birthday in June 
of this year, finally back from its 
summer hiatus. 


RASPBERRY JAM 

@ PI TOWERS 

When: Saturday 16 September 

Where: Raspberry Pi HQ, 
Cambridge, UK 

magpi.cc/2wgBoxb 

A family-friendly event where 

everyone is welcome, providing 

coding and digital making activities 

for children and adults. 
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WE'VE HIGHLIGHTED SOME OF 
THE AREAS IN NEED OF A JAM! 
CAN YOU HELP OUT? 
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FINDING 
VOLUNTEERS 


“You'll find that a lot of the people who 
attend your first Jam will become your 
future volunteers” 


Mike Horne 
Cambridge Raspberry Jam 


Every Raspberry Jam is entitled to apply 
for a Jam starter kit, which includes 
magazines, printed worksheets, stickers, 
flyers, and more. Download the book here: 
magpi.cc/2q9DHfQ. 
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You can 

find out how to 
burn an SD card 
with Etcher ona 
PC by following 
our video tutorial: 
magpi.cc/2sj7leN 


LETTERS 


i 


Magazine 


Etcher on Pi 


I followed the instructions in the article about 
how to use Etcher with Raspberry Pi SD cards. 
However, I am unable to make it work. I used 

the code below: 


cd Downloads 
chmod a+x Etcher-linux-x64.AppImage 
./Etcher-linux-x64.AppImage 


I get an error and I am unable to make Etcher 
run. The error is: ‘cannot execute binary file: 
Exec format error”. Can you help? 

CuteCobra 


Maker Faire New York 

I see The MagPi attends some events in the 

UK, such as the birthday parties and Pi Wars. I 
understand you’re a UK-based magazine. However, 
I was wondering if your team would be making 

an appearance at a US Jam or event of some sort? 
Would love to meet you guys! 

Angela L 


We don’t exhibit at events often enough, really! It’s fun 
and great to meet people, but it does take a lot of time. 
Having said that, if you’re at Maker Faire New York this 
September, some MagPi team members will be helping 
out at the Raspberry Pi stall, so if you’re attending you 
can come and see us. Even if you can’t get to New York, 
you can usually find some MagPi-related goodies on 
Raspberry Pi stalls at events across the USA. 


Unfortunately, Etcher doesn’t work on the 
Raspberry Pi: the packages you can download for 
Linux are either x86 or x86_64, which are meant 
to run on a normal PC - in this case a normal PC 
running Linux. 

You can’t burn a downloaded Raspbian image 
to another SD card on the Raspberry Pi in the same 
way as using Etcher on a PC. However, with the 
SD Card Copier tool in Raspbian, you can make a 
copy of your current SD card to another SD card 
connected via a USB card reader. The software 
will guide you through the process. 

The article this reader is referring to can be found 
here: magpi.cc/2fZkyJD. 


GETTING THE AIY 
PROJECTS VOICE KIT 


We're still getting emails from a lot of people asking 
how they can get their hands on issue 57 or the AIY 


Projects Voice Kit that came with it. We're adding 

a boxout here to remind everyone that the kit will 

be going on sale on its own soon. To find out when 
the kits will be available, sign up to our mailing list 

at magpi.cc/Email-me. That way, we can let you know 
as soon as We have a date for the release of the kits. 
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FROM THE FORUM: 


The Raspberry Pi Forum is a hotbed of conversations and problem-solving 
for the community. Join in via raspberrypi.org/forums 


have just received the latest The MagPi #60, Is the latest one safe to use? How do I know it’s safe? 
and was delighted to find the attached Many thanks, 
Raspberry Pi Desktop x86 DVD. Unfortunately CraigT 

I then realised I hadn’t bothered adding a DVD drive 


to my new computer. My intention was to run it in For future reference, you can easily find the ISO of 

VirtualBox, so ideally I just need an ISO image. the latest x86 Raspberry Pi Desktop build by going 
Where would the best place be to download the to rpf.io/x86, set up by Raspberry Pi Community 

latest version of the ISO image (happy to do so as Manager Ben Nuttall. The one you pointed to in the 

a torrent)? forum thread was the latest version. As a general rule, 
Quite a few blogs from last year point to another if they’re hosted on the Raspberry Pi website, they’re 

image but I found a different one that seems to be safe to use. If they’re beta release or some other form 

more up to date. of non-stable release, they will be labelled as such. 


WD PIDRIVE NODE ZERO 


Build your own mini DLNA + Samba file server, wireless 
mobile storage device, a Pi Music Box with local storage 
and so much more. 


Includes: 

* 314GB WD PiDrive, Raspberry Pi Zero, 
and custom adapter board 

¢ SD card with starter software 

e Mini HDMI adapter cable 


Learn more at wdlabs.io/mp60c 


WD, the WD logo, WDL 
m HDMI is a trad k 


, and the WOLabs k are 


5. Raspberry Pi is a trademark of the Raspberry Pi Foundation. microSD is a trademark of $D-3C, 
for storage capacity, one gigabyte = one billion bytes. Total accessible c 


i | 
START A CODE CLUB 
IN YOUR SCHOOL! 


Code Club is a network of volunteers and educators who 
run free coding clubs for young people aged 9-13. 


Our aim is to inspire the next generation to 
get excited about computer science and digital making. 


“We use Code Club's fun educational resources to run a 
weekly after-school club for Year 7 and Year 8 pupils. The 
students benefit considerably from the extra challenge!” 


Karen Dadd, Computing Teacher 


KA Code Club is free 


KA Code Club provides step-by-step guides for 
Scratch, Python, HTML, and Sonic Pi 


KA Code Club helps children develop skills including 
logical thinking, creativity, and resilience 


We have over 6000 clubs across the UK teaching 
more than 80,000 young people to code—come and join us!” 


Find out more at www.codeclub.org.uk 


Code Club is part of the Raspberry Pi Foundation. Registered Charity Number 1129409 os) 
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www. ThePiHut.com 


WIN! 


RASPBERRY PI 3 


RETRO 


GAMING BUNDLES 


We’ve got three Raspberry Pi 3 retro gaming 
bundles up for grabs, worth £65 each. 


Not only that, 15 lucky runners-up will get 
a SNES-style Raspberry Pi game pad. 


These great prizes are courtesy of The Pi Hut: 
thepihut.com 


Learn more about the retro gaming bundle at 
magpi.cc/2uY6K9Y 


Terms & Conditions 

Competition opens on 30 August 2017 and closes on 28 September 2017. Prize is offered to participants world-wide aged 13 or over, except employees of the 
Raspberry Pi Foundation, the prize supplier, their families or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering 
the competition, the winner consents to any publicity generated from the competition, in print and online. Participants agree to receive occasional newsletters from 
The MagPi magazine. We don't like spam: participants’ details will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and 


no cash alternative will be offered. This promotion is in no way sponsored, endorsed or administered by, or associated with, Instagram or Facebook. 
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Column THE FINAL WORD 


MATT RICHARDSON 


Matt is Raspberry Pi's US-based product evangelist. Before 
that, he was co-author of Getting Started with Raspberry Pi 
and a contributing editor at Make: magazine. 


, RASPBERRY PI AND 
* MICROCONTROLLERS: 


$ L A POWERFUL PAIRING 


hen I first joined the maker movement in 

2010, microcontrollers such as Arduino were 

already an indispensable tool for making 
things with technology. I used Arduino in many of 
my projects because it was so easy to program, and 
there was a ton of easy-to-follow examples and 
community support available. At the time, some of 
my projects involved operations such as saving data 
and hosting a web server, which would push any 
microcontroller of that era to its limits. 

Therefore, when maker-friendly single-board 
computers like Raspberry Pi came onto the scene, 
I started to think a lot about how their powerful 
processors would be useful for more advanced 
projects. Coupled with the on-board general- 
purpose input and output pins, it meant makers had 
new tools at their disposal to push the boundaries of 
what’s possible for their projects. 
There’s a lot of overlap in the functionality of 

a single-board computer and a microcontroller. 
Both have the ability to run code and interface with 
electronics. The strength of a single-board computer 
lies in its ability to do ‘high-level’ tasks, such as 
running web servers, writing to databases, capturing 
photos, executing computer vision algorithms, 
playing audio and video, and so on. Microcontrollers 
have their strengths as well. For example, they’re 
good at sending signals with precise timing, which 
is important for controlling some types of motors or 
addressable LEDs. Other advantages include their low 
energy consumption, their quick start-up time, and 
often they have built-in analogue input capability. 


Working together 

As a maker, having both microcontrollers and single- 
board computers in your toolbox means you can 
accomplish a broader range of projects. Choosing 

the right type of board based on your project’s needs 
is an important skill for a maker, but that doesn’t 
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Matt Richardson’s take on how two popular technologies work together 


necessarily mean that you”ll choose one or the 
other. A single-board computer can work well with 
a microcontroller in a unified project. 

A simple serial communications connection 
between a Raspberry Pi and Arduino means that the 
two boards can talk to each other and pass data back 
and forth. For example, if you were making your 
own pen plotter, you may have a microcontroller 
controlling the stepper motors which move the pen. 
The data could be fed to the microcontroller by a 
single-board computer, which shows a user interface 
on a screen or via a built-in web server. 


Their strong 
interoperability opens 
up so many possibilities 


The way that the two platforms work together 
doesn’t stop there. A microcontroller isn’t very 
useful if you don’t have a computer to write the code 
and upload it to the board. Luckily, the Arduino’s 
development environment runs nicely on Raspberry 
Pi’s Raspbian operating system. So even if your 
project doesn’t call for anything more than a 
microcontroller, why not use your Raspberry Pi 
to program it? 

Contrary to what some may believe, 
microcontrollers and single-board computers aren’t 
competitors, but partners. While there’s a lot of 
overlap in the functionality of both types of devices, 
they’re both great tools to have in your maker toolbox. 
Their strong interoperability opens up so many 
possibilities for rather complex projects. When you 
make with both microcontrollers and single-board 
computers, the whole is greater than the sum of the 
parts — and that makes them a powerful pair. 
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